Get role

GET /api/roles/{id}

Get role details by ID.

Path parameters

  • id string Required

    The unique identifier of the role.

Responses

  • 200 application/json

    Details of the role.

    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 Required

      Minimum length is 1, maximum length is 128.

    • type string Required

      Values are User or MachineToMachine.

  • 400

    Bad Request

  • 401

    Unauthorized

  • 403

    Forbidden

  • 404

    Not Found

GET /api/roles/{id}
curl \
 -X GET https://[tenant_id].logto.app/api/roles/{id}
Response examples (200)
{
  "id": "string",
  "name": "string",
  "description": "string",
  "type": "User"
}