List all the user consent scopes of an application.

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/applications/{applicationId}/user-consent-scopes
O auth2

List all the user consent scopes of an application by application id

Path parameters

  • applicationId string Required

    The unique identifier of the application.

Responses

  • 200 application/json

    All the user consent scopes of the application are listed successfully

    Hide response attributes Show response attributes object
    • organizationScopes array[object] Required

      A list of organization scope details assigned to the application.

      Hide organizationScopes attributes Show organizationScopes 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.

    • resourceScopes array[object] Required

      A list of resource scope details grouped by resource id assigned to the application.

      Hide resourceScopes attributes Show resourceScopes attributes object
      • resource object Required
        Hide resource attributes Show resource attributes object
        • id string Required

          Minimum length is 1, maximum length is 21.

        • name string Required

          Minimum length is 1.

        • indicator string Required

          Minimum length is 1.

      • scopes array[object] Required
        Hide scopes attributes Show scopes attributes object
        • id string Required

          Minimum length is 1, maximum length is 21.

        • name string Required

          Minimum length is 1, maximum length is 256.

        • description string | null Required
    • organizationResourceScopes array[object] Required

      A list of organization resource scope details grouped by resource id assigned to the application.

      Hide organizationResourceScopes attributes Show organizationResourceScopes attributes object
      • resource object Required
        Hide resource attributes Show resource attributes object
        • id string Required

          Minimum length is 1, maximum length is 21.

        • name string Required

          Minimum length is 1.

        • indicator string Required

          Minimum length is 1.

      • scopes array[object] Required
        Hide scopes attributes Show scopes attributes object
        • id string Required

          Minimum length is 1, maximum length is 21.

        • name string Required

          Minimum length is 1, maximum length is 256.

        • description string | null Required
    • userScopes array[string] Required

      A list of user scope enum value assigned to the application.

      Values are profile, email, phone, address, custom_data, identities, roles, urn:logto:scope:organizations, urn:logto:scope:organization_roles, or urn:logto:scope:sessions.
  • 400

    Bad Request

  • 401

    Unauthorized

  • 403

    Forbidden

  • 404

    The application is not found

GET /api/applications/{applicationId}/user-consent-scopes 
curl \
 --request GET 'https://[tenant_id].logto.app/api/applications/{applicationId}/user-consent-scopes' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "organizationScopes": [
    {
      "id": "string",
      "name": "string",
      "description": "string"
    }
  ],
  "resourceScopes": [
    {
      "resource": {
        "id": "string",
        "name": "string",
        "indicator": "string"
      },
      "scopes": [
        {
          "id": "string",
          "name": "string",
          "description": "string"
        }
      ]
    }
  ],
  "organizationResourceScopes": [
    {
      "resource": {
        "id": "string",
        "name": "string",
        "indicator": "string"
      },
      "scopes": [
        {
          "id": "string",
          "name": "string",
          "description": "string"
        }
      ]
    }
  ],
  "userScopes": [
    "profile"
  ]
}