---
descriptions:
  organization_role:
    self: 'The [Organization Role](/reference/roles/organization-role) object.'
    object: Distinguishes the Role object.
    id: Unique identifier of the Role.
    name: A descriptive name for the Role. This field does not need to be unique.
    slug: >-
      A unique key to reference the role within the organization. Must be
      lowercase and contain only letters, numbers, hyphens, and underscores.
    description: A description for the Role.
    permissions: A list of permission slugs assigned to the role.
    type: >-
      The type of Role. For organization roles, this is always
      `OrganizationRole`.
    resource_type_slug: The slug of the resource type the role is scoped to.
    created_at: The timestamp when the Role was created.
    updated_at: The timestamp when the Role was last updated.
reference:
  curl:
    - url: /reference/roles/organization-role
      key: organization_role
      id: organization_role
      title: Organization Role
      properties:
        - key: object
          type: '"role"'
          description: (organization_role.object)
        - key: id
          type: string
          description: (organization_role.id)
        - key: name
          type: string
          description: (organization_role.name)
        - key: slug
          type: string
          description: (organization_role.slug)
        - key: description
          type: string | null
          description: (organization_role.description)
        - key: permissions
          type: 'string[]'
          description: (organization_role.permissions)
        - key: type
          type: '"OrganizationRole"'
          description: (organization_role.type)
        - key: resource_type_slug
          type: string
          description: (organization_role.resource_type_slug)
        - key: created_at
          type: string
          description: (organization_role.created_at)
        - key: updated_at
          type: string
          description: (organization_role.updated_at)
  js:
    - url: /reference/roles/organization-role
      key: OrganizationRole
      id: organization_role
      title: OrganizationRole
      properties:
        - key: object
          type: '"role"'
          description: (organization_role.object)
        - key: id
          type: string
          description: (organization_role.id)
        - key: name
          type: string
          description: (organization_role.name)
        - key: slug
          type: string
          description: (organization_role.slug)
        - key: description
          type: string | null
          description: (organization_role.description)
        - key: permissions
          type: 'string[]'
          description: (organization_role.permissions)
        - key: type
          type: '"OrganizationRole"'
          description: (organization_role.type)
        - key: resourceTypeSlug
          type: string
          description: (organization_role.resource_type_slug)
        - key: createdAt
          type: string
          description: (organization_role.created_at)
        - key: updatedAt
          type: string
          description: (organization_role.updated_at)
  python:
    - url: /reference/roles/organization-role
      key: OrganizationRole
      id: organization_role
      title: OrganizationRole
      properties:
        - key: object
          type: str
          description: (organization_role.object)
        - key: id
          type: str
          description: (organization_role.id)
        - key: name
          type: str
          description: (organization_role.name)
        - key: slug
          type: str
          description: (organization_role.slug)
        - key: description
          type: str | None
          description: (organization_role.description)
        - key: permissions
          type: 'list[str]'
          description: (organization_role.permissions)
        - key: type
          type: str
          description: (organization_role.type)
        - key: resource_type_slug
          type: str
          description: (organization_role.resource_type_slug)
        - key: created_at
          type: str
          description: (organization_role.created_at)
        - key: updated_at
          type: str
          description: (organization_role.updated_at)
originalPath: >-
  .tmp-workos-clone/packages/docs/content/reference/roles/organization-role/index.mdx
---

# Organization Role

An organization role is an access control resource defined at the organization level. Organization roles allow individual organizations to create custom roles tailored to their specific needs, in addition to the environment roles that apply across all organizations.

Like environment roles, organization roles can be assigned to [organization memberships](/reference/authkit/organization-membership), [directory users](/directory-sync/identity-provider-role-assignment), and [SSO profiles](/sso/identity-provider-role-assignment). Each organization role has a unique slug identifier within the organization and can have permissions assigned to it.

<Callout type="info">
  When listing roles for an organization, both environment roles and
  organization roles are returned in priority order. Environment roles are
  included because they apply to all organizations in your environment.
</Callout>

<CodeBlock
  title="Organization Role"
  file="organization-role"
  referenceId="organization_role"
/>