# clerk_organization_permission (Resource)

A custom organization permission. Reference its id in the `permissions` set of a `clerk_organization_role`.

## Example Usage

```terraform
resource "clerk_organization_permission" "invoices_read" {
  name        = "Read invoices"
  key         = "org:invoices:read"
  description = "Read access to the invoices of the organization."
}
```

<!-- schema generated by tfplugindocs -->
## Schema

### Required

- `key` (String) Permission key, for example `org:invoices:read`.
- `name` (String) Display name.

### Optional

- `description` (String) Free-form description.

### Read-Only

- `id` (String) Permission id (`perm_...`).
- `type` (String) `system` or `user`. Custom permissions are `user`.

## Import

Import is supported using the following syntax:

The [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import) can be used, for example:

```shell
terraform import clerk_organization_permission.invoices_read perm_2abcDEFghiJKLmnoPQRstuVWXyz
```