Get organization role

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://openapi.logto.io/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
"Logto API references MCP server": {
  "url": "https://openapi.logto.io/mcp"
}
Close
GET /api/organization-roles/{id}
O auth2

Get organization role details by ID.

Path parameters

  • id string Required

    The unique identifier of the organization role.

Responses

  • 200 application/json

    Details of the organization role.

    Hide response attributes Show response attributes object
    • tenantId string Required

      Maximum length is 21.

    • 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.

    • type string Required

      Values are User or MachineToMachine.
  • 400

    Bad Request

  • 401

    Unauthorized

  • 403

    Forbidden

  • 404

    Not Found

GET /api/organization-roles/{id} 
curl \
 --request GET 'https://[tenant_id].logto.app/api/organization-roles/{id}' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "tenantId": "string",
  "id": "string",
  "name": "string",
  "description": "string",
  "type": "User"
}