Update organization role

PATCH /api/organization-roles/{id}

Update organization role details by ID with the given data.

Path parameters

  • id string Required

    The unique identifier of the organization role.

application/json

Body Required

  • id string

    Minimum length is 1, maximum length is 21.

  • name string

    The updated name of the organization role. It must be unique within the organization template.

    Minimum length is 1, maximum length is 128.

  • description string | null

    The updated description of the organization role.

    Maximum length is 256.

Responses

  • 200 application/json

    The organization role was updated successfully.

    Hide response attributes Show response attributes object
    • id string Required

      Minimum length is 1, maximum length is 21.

    • name string Required

      Minimum length is 1, maximum length is 128.

    • description string | null Required

      Maximum length is 256.

  • 400

    Bad Request

  • 401

    Unauthorized

  • 403

    Forbidden

  • 404

    Not Found

  • 422

    The organization role name is already in use.

PATCH /api/organization-roles/{id}
curl \
 -X PATCH https://[tenant_id].logto.app/api/organization-roles/{id} \
 -H "Content-Type: application/json" \
 -d '{"id":"string","name":"string","description":"string"}'
Request examples
{
  "id": "string",
  "name": "string",
  "description": "string"
}
Response examples (200)
{
  "id": "string",
  "name": "string",
  "description": "string"
}