---
descriptions:
  add_organization_role_permission:
    slug: The slug of the permission to add to the role.
reference:
  curl:
    - key: add_organization_role_permission
      id: add_organization_role_permission
      url: /reference/roles/organization-role/add-permission
      title: '/authorization/organizations/:id/roles/:slug/permissions'
      type: POST
      parameters:
        - key: slug
          type: string
          description: (add_organization_role_permission.slug)
      returns:
        - (organization_role)
  js:
    - key: addOrganizationRolePermission
      id: add_organization_role_permission
      url: /reference/roles/organization-role/add-permission
      title: authorization.addOrganizationRolePermission()
      parameters:
        - key: organizationId
          type: string
          description: The ID of the organization.
        - key: roleSlug
          type: string
          description: The slug of the role.
        - key: options
          type: object
          unwrap: true
          properties:
            - key: permissionSlug
              type: string
              description: (add_organization_role_permission.slug)
      returns:
        - key: OrganizationRole
          description: (organization_role.self)
  python:
    - key: add_organization_role_permission
      id: add_organization_role_permission
      url: /reference/roles/organization-role/add-permission
      title: authorization.add_organization_role_permission()
      parameters:
        - key: organization_id
          type: str
          description: The ID of the organization.
        - key: slug
          type: str
          description: The slug of the role.
        - key: permission_slug
          type: str
          description: (add_organization_role_permission.slug)
      returns:
        - key: OrganizationRole
          description: (organization_role.self)
originalPath: >-
  .tmp-workos-clone/packages/docs/content/reference/roles/organization-role/add-permission.mdx
---

## Add a permission to an organization role

Add a single permission to an organization role. If the permission is already assigned to the role, this operation has no effect.

<CodeBlock referenceId="add_organization_role_permission">
  <CodeBlockTab
    title="Request"
    file="add-organization-role-permission-request"
  />
  <CodeBlockTab
    title="Response"
    file="add-organization-role-permission-response"
  />
</CodeBlock>