Assign roles to applications in an organization

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
POST /api/organizations/{id}/applications/roles
O auth2

Assign roles to applications in the specified organization.

Path parameters

  • id string Required

    The unique identifier of the organization.

application/json

Body Required

  • applicationIds array[string] Required

    An array of application IDs to assign roles to.

    Minimum length of each is 1.

  • organizationRoleIds array[string] Required

    An array of organization role IDs to assign to the applications.

    Minimum length of each is 1.

Responses

  • 201 application/json

    Roles were assigned to the applications successfully.

  • 400

    Bad Request

  • 401

    Unauthorized

  • 403

    Forbidden

  • 422

    At least one of the IDs provided is not valid. For example, the organization ID, application ID, or organization role ID does not exist; the application is not a member of the organization; or the role type is not assignable to the application.

POST /api/organizations/{id}/applications/roles 
curl \
 --request POST 'https://[tenant_id].logto.app/api/organizations/{id}/applications/roles' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"applicationIds":["string"],"organizationRoleIds":["string"]}'
Request examples 
{
  "applicationIds": [
    "string"
  ],
  "organizationRoleIds": [
    "string"
  ]
}