---
descriptions:
  remove_role_by_id:
    organization_membership_id: The ID of the organization membership.
    role_assignment_id: The ID of the role assignment to remove.
reference:
  curl:
    - key: remove_role_by_id
      id: remove_role_by_id
      url: /reference/fga/role-assignment/delete-by-id
      title: >-
        /authorization/organization_memberships/:organization_membership_id/role_assignments/:role_assignment_id
      type: DELETE
      parameters:
        - key: organization_membership_id
          type: string
          description: (remove_role_by_id.organization_membership_id)
        - key: role_assignment_id
          type: string
          description: (remove_role_by_id.role_assignment_id)
      returns:
        - key: empty
          type: empty
          description: Returns an empty response on success.
  js:
    - key: removeRoleAssignment
      id: remove_role_by_id
      url: /reference/fga/role-assignment/delete-by-id
      title: authorization.removeRoleAssignment()
      parameters:
        - key: options
          type: object
          unwrap: true
          properties:
            - key: organizationMembershipId
              type: string
              description: (remove_role_by_id.organization_membership_id)
            - key: roleAssignmentId
              type: string
              description: (remove_role_by_id.role_assignment_id)
      returns:
        - key: void
          description: Returns nothing on success.
originalPath: >-
  .tmp-workos-clone/packages/docs/content/reference/fga/role-assignment/delete-by-id.mdx
---

## Remove a role assignment by ID

Remove a role assignment using its ID. Access is revoked immediately. Removing an assignment also removes any permissions that were inherited by child resources through that assignment.

<Callout type="warning">
  This removes the specific role assignment, but direct assignments on child
  resources remain intact.
</Callout>

<CodeBlock referenceId="remove_role_by_id">
  <CodeBlockTab title="Request" file="remove-role-by-id-request" />
</CodeBlock>