Logto API references logo
API Changelog
Download source
  • JSON OpenAPI specification
  • YAML OpenAPI specification
dev
  • main default
  • dev

Topics

  • Introduction
  • Authentication

Endpoints

  • Account center
    • Get account center settings GET
    • Update account center settings PATCH
  • Applications
    • Get applications GET
    • Create an application POST
    • Get application GET
    • Delete application DELETE
    • Update application PATCH
    • Update application custom data PATCH
    • Get application API resource roles GET
    • Update API resource roles for application PUT
    • Assign API resource roles to application POST
    • Remove a API resource role from application DELETE
    • Get application custom domains. GET
    • Add a custom domain to the application. POST
    • Remove custom domain. DELETE
    • Get application organizations GET
    • Delete application legacy secret DELETE
    • Get application secrets GET
    • Add application secret POST
    • Delete application secret DELETE
    • Update application secret PATCH
    • List all the user consent scopes of an application. GET
    • Assign user consent scopes to application. POST
    • Remove user consent scope from application. DELETE
    • Get the application level sign-in experience GET
    • Update application level sign-in experience PUT
    • List all the user consented organizations of a application. GET
    • Grant a list of organization access of a user for a application. PUT
    • Grant a list of organization access of a user for a application. POST
    • Revoke a user's access to an organization for a application. DELETE
  • Audit logs
    • Get logs GET
    • Get log GET
  • Authn
    • Hasura auth hook endpoint GET
    • SAML ACS endpoint (social) POST
    • SAML ACS endpoint (SSO) POST
  • Captcha provider
    • Get captcha provider GET
    • Update captcha provider PUT
    • Delete captcha provider DELETE
  • Configs
    • Get admin console config GET
    • Update admin console config PATCH
    • Get OIDC keys GET
    • Delete OIDC key DELETE
    • Rotate OIDC keys POST
    • Get JWT customizer GET
    • Create or update JWT customizer PUT
    • Delete JWT customizer DELETE
    • Update JWT customizer PATCH
    • Get all JWT customizers GET
    • Test JWT customizer POST
  • Connector factories
    • Get connector factories GET
    • Get connector factory GET
  • Connectors
    • Get connectors GET
    • Create connector POST
    • Get connector GET
    • Delete connector DELETE
    • Update connector PATCH
    • Test passwordless connector POST
    • Get connector's authorization URI POST
  • Custom phrases
    • Get all custom phrases GET
    • Get custom phrases GET
    • Upsert custom phrases PUT
    • Delete custom phrase DELETE
  • Dashboard
    • Get total user count GET
    • Get new user count GET
    • Get active user data GET
  • Domains
    • Get domains GET
    • Create domain POST
    • Get domain GET
    • Delete domain DELETE
  • Email templates
    • Get email templates GET
    • Replace email templates PUT
    • Delete email templates DELETE
    • Get email template by ID GET
    • Delete an email template DELETE
    • Update email template details PATCH
  • Experience
    • Init new interaction PUT
    • Update interaction event PUT
    • Identify user for the current interaction POST
    • Submit interaction POST
    • Create password verification record POST
    • Create and send verification code POST
    • Verify verification code POST
    • Create social verification POST
    • Verify social verification POST
    • Create enterprise SSO verification POST
    • Verify enterprise SSO verification POST
    • Create TOTP secret POST
    • Verify TOTP verification POST
    • Create WebAuthn registration verification POST
    • Verify WebAuthn registration verification POST
    • Create WebAuthn authentication verification POST
    • Verify WebAuthn authentication verification POST
    • Generate backup codes POST
    • Verify backup code POST
    • Create new password identity verification POST
    • Verify one-time token POST
    • Add user profile POST
    • Reset user password PUT
    • Skip MFA binding flow POST
    • Bind MFA verification by verificationId POST
    • Get enabled SSO connectors by the given email's domain GET
  • Hooks
    • Get hooks GET
    • Create a hook POST
    • Get hook GET
    • Delete hook DELETE
    • Update hook PATCH
    • Get recent logs for a hook GET
    • Test hook POST
    • Update signing key for a hook PATCH
  • Interaction
    • PUT /api/interaction PUT
    • DELETE /api/interaction DELETE
    • PUT /api/interaction/event PUT
    • PATCH /api/interaction/identifiers PATCH
    • PUT /api/interaction/profile PUT
    • DELETE /api/interaction/profile DELETE
    • PATCH /api/interaction/profile PATCH
    • POST /api/interaction/submit POST
    • GET /api/interaction/consent GET
    • POST /api/interaction/consent POST
    • POST /api/interaction/verification/social-authorization-uri POST
    • POST /api/interaction/verification/verification-code POST
    • POST /api/interaction/verification/totp POST
    • POST /api/interaction/verification/webauthn-registration POST
    • POST /api/interaction/verification/webauthn-authentication POST
    • POST /api/interaction/bind-mfa POST
    • PUT /api/interaction/mfa PUT
    • PUT /api/interaction/mfa-skipped PUT
    • POST /api/interaction/single-sign-on/{connectorId}/authorization-url POST
    • POST /api/interaction/single-sign-on/{connectorId}/authentication POST
    • POST /api/interaction/single-sign-on/{connectorId}/registration POST
    • GET /api/interaction/single-sign-on/connectors GET
  • My account
    • Get profile GET
    • Update profile PATCH
    • Update other profile PATCH
    • Update password POST
    • Update primary email POST
    • Delete primary email DELETE
    • Update primary phone POST
    • Delete primary phone DELETE
    • Add a user identity POST
    • Delete a user identity DELETE
  • One-time tokens
    • Get one-time tokens GET
    • Create one-time token POST
    • Get one-time token by ID GET
    • Delete one-time token by ID DELETE
    • Verify one-time token POST
    • Update one-time token status PUT
  • Organization invitations
    • Get organization invitation GET
    • Delete organization invitation DELETE
    • Get organization invitations GET
    • Create organization invitation POST
    • Resend invitation message POST
    • Update organization invitation status PUT
  • Organization roles
    • Get organization role GET
    • Delete organization role DELETE
    • Update organization role PATCH
    • Get organization roles GET
    • Create an organization role POST
    • Get organization role scopes GET
    • Replace organization scopes for organization role PUT
    • Assign organization scopes to organization role POST
    • Remove organization scope DELETE
    • Get organization role resource scopes GET
    • Replace resource scopes for organization role PUT
    • Assign resource scopes to organization role POST
    • Remove resource scope DELETE
  • Organization scopes
    • Get organization scopes GET
    • Create an organization scope POST
    • Get organization scope GET
    • Delete organization scope DELETE
    • Update organization scope PATCH
  • Organizations
    • Get organizations GET
    • Create an organization POST
    • Get organization GET
    • Delete organization DELETE
    • Update organization PATCH
    • Get organization user members GET
    • Replace organization user members PUT
    • Add user members to organization POST
    • Remove user member from organization DELETE
    • Assign roles to organization user members POST
    • Get roles for a user in an organization GET
    • Update roles for a user in an organization PUT
    • Assign roles to a user in an organization POST
    • Remove a role from a user in an organization DELETE
    • Get scopes for a user in an organization tailored by the organization roles GET
    • Get organization applications GET
    • Replace organization applications PUT
    • Add organization application POST
    • Remove organization application DELETE
    • Assign roles to applications in an organization POST
    • Get organization application roles GET
    • Replace organization application roles PUT
    • Add organization application role POST
    • Remove organization application role DELETE
    • Get organization JIT email domains GET
    • Replace organization JIT email domains PUT
    • Add organization JIT email domain POST
    • Remove organization JIT email domain DELETE
    • Get organization JIT default roles GET
    • Replace organization JIT default roles PUT
    • Add organization JIT default roles POST
    • Remove organization JIT default role DELETE
    • Get organization JIT SSO connectors GET
    • Replace organization JIT SSO connectors PUT
    • Add organization JIT SSO connectors POST
    • Remove organization JIT SSO connector DELETE
  • Resources
    • Get API resources GET
    • Create an API resource POST
    • Get API resource GET
    • Delete API resource DELETE
    • Update API resource PATCH
    • Set API resource as default PATCH
    • Get API resource scopes GET
    • Create API resource scope POST
    • Delete API resource scope DELETE
    • Update API resource scope PATCH
  • Roles
    • Get roles GET
    • Create a role POST
    • Get role GET
    • Delete role DELETE
    • Update role PATCH
    • Get role users GET
    • Assign role to users POST
    • Remove role from user DELETE
    • Get role applications GET
    • Assign role to applications POST
    • Remove role from application DELETE
    • Get role scopes GET
    • Link scopes to role POST
    • Unlink scope from role DELETE
  • SAML applications
    • Create SAML application POST
    • Get SAML application GET
    • Delete SAML application DELETE
    • Update SAML application PATCH
    • List SAML application secrets GET
    • Create SAML application secret POST
    • Delete SAML application secret DELETE
    • Update SAML application secret PATCH
    • Get SAML application metadata GET
    • SAML application callback GET
  • SAML applications auth flow
    • Handle SAML authentication request (Redirect binding) GET
    • Handle SAML authentication request (POST binding) POST
  • Sentinel activities
    • Bulk delete sentinel activities POST
  • Sign-in experience
    • Get default sign-in experience settings GET
    • Update default sign-in experience settings PATCH
    • Check if a password meets the password policy POST
    • Upload custom UI assets POST
  • SSO connector providers
    • List all the supported SSO connector provider details GET
  • SSO connectors
    • List SSO connectors GET
    • Create SSO connector POST
    • Get SSO connector GET
    • Delete SSO connector DELETE
    • Update SSO connector PATCH
    • Get IdP initiated auth config GET
    • Set IdP initiated auth config PUT
    • Delete IdP initiated auth config DELETE
  • Status
    • Health check GET
  • Subject tokens
    • Create a new subject token. POST
  • Swagger.json
    • Get Swagger JSON GET
  • Systems
    • Get the application constants. GET
  • User assets
    • Get service status GET
    • Upload asset POST
  • Users
    • Get user GET
    • Delete user DELETE
    • Update user PATCH
    • Get user custom data GET
    • Update user custom data PATCH
    • Update user profile PATCH
    • Get users GET
    • Create user POST
    • Update user password PATCH
    • Verify user password POST
    • Check if user has password GET
    • Update user suspension status PATCH
    • Get roles for user GET
    • Update roles for user PUT
    • Assign roles to user POST
    • Remove role from user DELETE
    • Update social identity of user PUT
    • Delete social identity from user DELETE
    • Link social identity to user POST
    • Get organizations for a user GET
    • Get user's MFA verifications GET
    • Create an MFA verification for a user POST
    • Delete an MFA verification for a user DELETE
    • Get personal access tokens GET
    • Add personal access token POST
    • Delete personal access token DELETE
    • Update personal access token PATCH
  • Verification codes
    • Request and send a verification code POST
    • Verify a verification code POST
  • Verifications
    • Create a record by password POST
    • Create a record by verification code POST
    • Verify verification code POST
    • Create a social verification record POST
    • Verify a social verification record POST
  • Well-known
    • Get full sign-in experience GET
    • Get localized phrases GET
    • Get full sign-in experience GET
    • Get Management API swagger JSON GET
    • Get Experience API swagger JSON GET
    • Get User API swagger JSON GET
Powered by Bump.sh

GET /api/interaction/consent

GET /api/interaction/consent

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • application object Required
      Hide application attributes Show application attributes object
      • id string Required

        Minimum length is 1, maximum length is 21.

      • name string Required

        Minimum length is 1, maximum length is 256.

      • branding object
        Hide branding attributes Show branding attributes object
        • logoUrl string(url)
        • darkLogoUrl string(url)
        • favicon string(url)
        • darkFavicon string(url)
      • displayName string | null

        Maximum length is 256.

      • privacyPolicyUrl string | null

        Maximum length is 2048.

      • termsOfUseUrl string | null

        Maximum length is 2048.

    • user object Required
      Hide user attributes Show user attributes object
      • id string Required

        Minimum length is 1, maximum length is 12.

      • name string | null Required

        Maximum length is 128.

      • avatar string | null Required

        Maximum length is 2048.

      • username string | null Required

        Maximum length is 128.

      • primaryEmail string | null Required

        Maximum length is 128.

      • primaryPhone string | null Required

        Maximum length is 128.

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

        Minimum length is 1, maximum length is 21.

      • name string Required

        Minimum length is 1, maximum length is 128.

      • missingResourceScopes array[object]
        Hide missingResourceScopes attributes Show missingResourceScopes attributes object
        • resource object Required
          Hide resource attributes Show resource attributes object
          • name string Required

            Minimum length is 1.

          • indicator string Required

            Minimum length is 1.

          • id string Required
        • 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
    • missingOIDCScope array[string]
    • missingResourceScopes array[object]
      Hide missingResourceScopes attributes Show missingResourceScopes attributes object
      • resource object Required
        Hide resource attributes Show resource attributes object
        • name string Required

          Minimum length is 1.

        • indicator string Required

          Minimum length is 1.

        • id string Required
      • 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
    • redirectUri string Required
GET /api/interaction/consent
curl \
 --request GET 'https://[tenant_id].logto.app/api/interaction/consent'
Response examples (200)
{
  "application": {
    "id": "string",
    "name": "string",
    "branding": {
      "logoUrl": "string",
      "darkLogoUrl": "string",
      "favicon": "string",
      "darkFavicon": "string"
    },
    "displayName": "string",
    "privacyPolicyUrl": "string",
    "termsOfUseUrl": "string"
  },
  "user": {
    "id": "string",
    "name": "string",
    "avatar": "string",
    "username": "string",
    "primaryEmail": "string",
    "primaryPhone": "string"
  },
  "organizations": [
    {
      "id": "string",
      "name": "string",
      "missingResourceScopes": [
        {
          "resource": {
            "name": "string",
            "indicator": "string",
            "id": "string"
          },
          "scopes": [
            {
              "id": "string",
              "name": "string",
              "description": "string"
            }
          ]
        }
      ]
    }
  ],
  "missingOIDCScope": [
    "string"
  ],
  "missingResourceScopes": [
    {
      "resource": {
        "name": "string",
        "indicator": "string",
        "id": "string"
      },
      "scopes": [
        {
          "id": "string",
          "name": "string",
          "description": "string"
        }
      ]
    }
  ],
  "redirectUri": "string"
}