ApiManagementSso apps
GET
/v1/mgmt/sso/idp/apps/load

Authorization

Descope Project ID and Management Key
AuthorizationBearer <token>

Project ID:Management Key as bearer token.

In: header

Load all Applications within a project

This endpoint returns details of all Applications within your Descope project.

See Also

curl -X GET "https://api.descope.com/v1/mgmt/sso/idp/apps/load"
{  "apps": [    {      "id": "string",      "name": "string",      "description": "string",      "enabled": true,      "logo": "string",      "appType": "string",      "samlSettings": {        "loginPageUrl": "string",        "idpCert": "string",        "useMetadataInfo": true,        "metadataUrl": "string",        "entityId": "string",        "acsUrl": "string",        "certificate": "string",        "attributeMapping": [          {            "name": "string",            "type": "string",            "value": "string"          }        ],        "groupsMapping": [          {            "name": "string",            "type": "string",            "filterType": "string",            "value": "string",            "roles": [              {                "id": "string",                "name": "string"              }            ]          }        ],        "idpMetadataUrl": "string",        "idpEntityId": "string",        "idpSsoUrl": "string",        "acsAllowedCallbacks": [          "string"        ],        "subjectNameIdType": "string",        "subjectNameIdFormat": "string",        "defaultRelayState": "string",        "idpInitiatedUrl": "string",        "forceAuthentication": true,        "idpLogoutUrl": "string",        "logoutRedirectUrl": "string",        "errorRedirectUrl": "string",        "defaultSignatureAlgorithm": "string"      },      "oidcSettings": {        "loginPageUrl": "string",        "issuer": "string",        "discoveryUrl": "string",        "claims": [          "string"        ],        "forceAuthentication": true,        "jwtBearerSettings": {          "issuers": {            "property1": {              "jwksUri": "string",              "signAlgorithm": "string",              "userInfoUri": "string",              "externalIdFieldName": "string"            },            "property2": {              "jwksUri": "string",              "signAlgorithm": "string",              "userInfoUri": "string",              "externalIdFieldName": "string"            }          },          "jwtBearerGrantTypeAudienceToUse": "string",          "jwtBearerGrantTypeScopeToUse": "string",          "jwtBearerGrantTypeCustomClaimsToUse": "string"        },        "backChannelLogoutUrl": "string",        "customIdpInitiatedLoginPageUrl": "string",        "sessionSettings": {          "enabled": true,          "refreshTokenExpiration": 0,          "refreshTokenExpirationUnit": "string",          "sessionTokenExpiration": 0,          "sessionTokenExpirationUnit": "string",          "userTemplateId": "string",          "keyTemplateId": "string",          "keySessionTokenExpiration": 0,          "keySessionTokenExpirationUnit": "string"        },        "clientId": "string",        "clientSecret": "string",        "clientType": "string",        "approvedRedirectUrls": [          "string"        ],        "authorizationCodeDisabled": true,        "clientCredentialsDisabled": true,        "refreshTokenDisabled": true,        "jwtBearerDisabled": true,        "deviceCodeDisabled": true,        "forcePkce": true,        "defaultAudience": "string",        "scopeClaimMapping": [          {            "scope": "string",            "claims": {              "property1": "string",              "property2": "string"            },            "description": "string",            "useProjectMapping": true,            "mandatory": true          }        ],        "trustedAppsAudience": "string",        "mtlsClientAuthMethods": {          "tlsClientAuth": {            "credentials": [              {                "id": "string",                "name": "string",                "subjectDn": "string",                "pem": "string",                "thumbprint": "string",                "createdAt": 0              }            ]          },          "selfSignedTlsClientAuth": {            "credentials": [              {                "id": "string",                "name": "string",                "subjectDn": "string",                "pem": "string",                "thumbprint": "string",                "createdAt": 0              }            ]          }        }      },      "customSettings": {        "loginPageUrl": "string",        "sessionSettings": {          "enabled": true,          "refreshTokenExpiration": 0,          "refreshTokenExpirationUnit": "string",          "sessionTokenExpiration": 0,          "sessionTokenExpirationUnit": "string",          "userTemplateId": "string",          "keyTemplateId": "string",          "keySessionTokenExpiration": 0,          "keySessionTokenExpirationUnit": "string"        }      },      "wsfedSettings": {        "loginPageUrl": "string",        "realm": "string",        "replyUrl": "string",        "attributeMapping": [          {            "name": "string",            "type": "string",            "value": "string"          }        ],        "groupsMapping": [          {            "name": "string",            "type": "string",            "filterType": "string",            "value": "string",            "roles": [              {                "id": "string",                "name": "string"              }            ]          }        ],        "forceAuthentication": true,        "logoutRedirectUrl": "string",        "errorRedirectUrl": "string",        "idpCert": "string",        "idpInitiatedUrl": "string",        "idpMetadataUrl": "string",        "idpEntityId": "string",        "idpSsoUrl": "string",        "idpLogoutUrl": "string",        "replyAllowedCallbacks": [          "string"        ]      },      "trustedAppIds": [        "string"      ],      "customAttributes": {        "attribute-key": "attribute-value"      },      "serviceAccountRoles": [        {          "targetAppId": "string",          "roleIds": [            "string"          ]        }      ]    }  ]}
export interface Response {apps?: {id?: string/** * int64 version - excluded *  int64 createdTime - excluded *  string projectId - copied */name?: stringdescription?: stringenabled?: booleanlogo?: stringappType?: stringsamlSettings?: SSOApplicationSAMLSettingsoidcSettings?: SSOApplicationOIDCSettingscustomSettings?: SSOApplicationCustomSettingswsfedSettings?: SSOApplicationWSFedSettings/** * trustedAppIds lists sibling SSO apps whose roles are included in this app's JWT under the *  `trustedApps` claim at login time. Only OIDC and Custom app types may set a non-empty value. */trustedAppIds?: string[]/** * Custom attributes as key-value pairs. Keys must be strings; values can be strings, numbers, booleans, or arrays. */customAttributes?: {[k: string]: string}/** * serviceAccountRoles assigns this app (when client_credentials is enabled) application-roles in its *  trusted apps; surfaced in its client_credentials token under the `app.trustedApps` claim. */serviceAccountRoles?: {targetAppId?: stringroleIds?: string[]}[]}[]}export interface SSOApplicationSAMLSettings {loginPageUrl?: stringidpCert?: stringuseMetadataInfo?: booleanmetadataUrl?: stringentityId?: stringacsUrl?: stringcertificate?: stringattributeMapping?: {name?: stringtype?: stringvalue?: string}[]groupsMapping?: {name?: stringtype?: stringfilterType?: stringvalue?: stringroles?: SAMLIDPRoleGroupMappingInfo[]}[]idpMetadataUrl?: stringidpEntityId?: stringidpSsoUrl?: stringacsAllowedCallbacks?: string[]subjectNameIdType?: stringsubjectNameIdFormat?: stringdefaultRelayState?: stringidpInitiatedUrl?: stringforceAuthentication?: booleanidpLogoutUrl?: stringlogoutRedirectUrl?: stringerrorRedirectUrl?: stringdefaultSignatureAlgorithm?: string}export interface SAMLIDPRoleGroupMappingInfo {id?: stringname?: string}export interface SSOApplicationOIDCSettings {loginPageUrl?: stringissuer?: stringdiscoveryUrl?: stringclaims?: string[]forceAuthentication?: booleanjwtBearerSettings?: {issuers?: {[k: string]: IssuerSettings}jwtBearerGrantTypeAudienceToUse?: stringjwtBearerGrantTypeScopeToUse?: stringjwtBearerGrantTypeCustomClaimsToUse?: string}backChannelLogoutUrl?: stringcustomIdpInitiatedLoginPageUrl?: stringsessionSettings?: {enabled?: booleanrefreshTokenExpiration?: numberrefreshTokenExpirationUnit?: stringsessionTokenExpiration?: numbersessionTokenExpirationUnit?: stringuserTemplateId?: stringkeyTemplateId?: stringkeySessionTokenExpiration?: numberkeySessionTokenExpirationUnit?: string}clientId?: stringclientSecret?: stringclientType?: stringapprovedRedirectUrls?: string[]authorizationCodeDisabled?: booleanclientCredentialsDisabled?: booleanrefreshTokenDisabled?: booleanjwtBearerDisabled?: booleandeviceCodeDisabled?: booleanforcePkce?: boolean/** * Default audience policy for issued tokens. Applies only to modern apps (non-empty clientType): *  'projectId', 'clientId', 'appId', empty (both), or 'empty' (no aud at all). Legacy apps are *  unaffected. Mirrors third-party apps. */defaultAudience?: string/** * Per-app scope→claims mapping. When non-empty, this mapping REPLACES the project-wide *  ScopeClaimMapping for tokens issued by this app: only scopes listed here can be requested *  (the set of scopes doubles as an allow-list — requesting an unlisted scope returns *  InvalidArguments), and only this mapping's claims are emitted. Per-entry useProjectMapping *  lets an app opt back into the project's claims for an individual scope without restating *  them. Empty list preserves today's behavior (no per-app restriction; project-wide mapping *  applies if configured). */scopeClaimMapping?: {scope?: string/** * claims is consulted only when useProjectMapping is false. When useProjectMapping is true, *  the project-wide mapping's entry for `scope` provides the claims and this field is ignored. */claims?: {[k: string]: string}description?: string/** * useProjectMapping, when true, reuses the project-wide ScopeClaimMapping's entry for this *  scope (the app's `claims` field is ignored). Default false uses the app's own `claims`. */useProjectMapping?: boolean/** * mandatory, when true, means the scope is always granted and cannot be deselected by the *  user on the consent screen. Mirrors the inverse of the legacy ApplicationScope.optional. */mandatory?: boolean}[]/** * Audience policy applied to trusted sibling apps' identifiers when appended to the issued token's *  `aud` (see SSOApplication.trustedAppIds). Same value set as defaultAudience: 'projectId' / *  'clientId' / 'appId' / empty (=both) / 'empty' (add none). Independent of defaultAudience. */trustedAppsAudience?: stringmtlsClientAuthMethods?: {tlsClientAuth?: TLSClientAuthselfSignedTlsClientAuth?: SelfSignedTLSClientAuth}}export interface IssuerSettings {jwksUri?: stringsignAlgorithm?: stringuserInfoUri?: stringexternalIdFieldName?: string}export interface TLSClientAuth {credentials?: {id?: stringname?: stringsubjectDn?: stringpem?: stringthumbprint?: stringcreatedAt?: number}[]}export interface SelfSignedTLSClientAuth {credentials?: MTLSClientAuthCredential[]}export interface MTLSClientAuthCredential {id?: stringname?: stringsubjectDn?: stringpem?: stringthumbprint?: stringcreatedAt?: number}export interface SSOApplicationCustomSettings {loginPageUrl?: stringsessionSettings?: {enabled?: booleanrefreshTokenExpiration?: numberrefreshTokenExpirationUnit?: stringsessionTokenExpiration?: numbersessionTokenExpirationUnit?: stringuserTemplateId?: stringkeyTemplateId?: stringkeySessionTokenExpiration?: numberkeySessionTokenExpirationUnit?: string}}export interface SSOApplicationWSFedSettings {loginPageUrl?: stringrealm?: stringreplyUrl?: stringattributeMapping?: {name?: stringtype?: stringvalue?: string}[]groupsMapping?: {name?: stringtype?: stringfilterType?: stringvalue?: stringroles?: SAMLIDPRoleGroupMappingInfo[]}[]forceAuthentication?: booleanlogoutRedirectUrl?: stringerrorRedirectUrl?: stringidpCert?: stringidpInitiatedUrl?: stringidpMetadataUrl?: stringidpEntityId?: stringidpSsoUrl?: stringidpLogoutUrl?: stringreplyAllowedCallbacks?: string[]}
Was this helpful?