{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/beyond-identity/json-schema/beyond-identity-list-applications-response-schema.json",
  "title": "List Applications Response",
  "description": "Response for ListApplications.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/beyond-identity-applications-api-openapi.yml#/components/schemas/ListApplicationsResponse",
  "type": "object",
  "properties": {
    "applications": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Application"
      },
      "maxItems": 100,
      "description": "An unordered array of applications corresponding to the request.\n"
    },
    "total_size": {
      "type": "integer",
      "format": "uint32",
      "description": "Total number of results returned by the operation. This value may be larger than the number of resources returned, such as when returning a single page where multiple pages are available.\n"
    },
    "next_page_token": {
      "type": "string",
      "description": "Token used to fetch the next set of results. If this field is omitted, there are no subsequent pages.\n"
    }
  },
  "required": [
    "applications",
    "total_size"
  ],
  "$defs": {
    "Application": {
      "title": "Application",
      "type": "object",
      "description": "An application represents a client application that uses Beyond Identity for authentication. This could be a native app, a single-page application, regular web application, or machine-to-machine application credentials.\n",
      "properties": {
        "id": {
          "type": "string",
          "description": "A unique identifier for an application. This is automatically generated on creation. This field is immutable and read-only. This field is unique within the realm.\n",
          "readOnly": true
        },
        "realm_id": {
          "type": "string",
          "description": "A unique identifier for the application's realm. This is automatically set on creation. This field is immutable and read-only.\n",
          "readOnly": true
        },
        "tenant_id": {
          "type": "string",
          "description": "A unique identifier for the application's tenant. This is automatically set on creation. This field is immutable and read-only.\n",
          "readOnly": true
        },
        "resource_server_id": {
          "type": "string",
          "description": "A unique identifier for the application's resource server. At present, the only available resource server is for the Beyond Identity Management API. Referencing this resource server from an application will allow that application to grant access to Beyond Identity's APIs. When not present, this application may provide authentication (identity) but not authorization (access).\n"
        },
        "authenticator_config_id": {
          "type": "string",
          "description": "A unique identifier for the application's authenticator configuration. This field is unused for `oidc` and `oauth2` applications when `grant_type=client_credentials`.\n"
        },
        "display_name": {
          "type": "string",
          "description": "A human-readable name for the application. This name is used for display purposes.\n"
        },
        "is_managed": {
          "type": "boolean",
          "description": "A boolean indicating whether the application is managed by Beyond Identity. Managed applications may not be modified by the user. This is automatically set on creation. This field is immutable and read-only.\n",
          "readOnly": true
        },
        "protocol_config": {
          "description": "Represents an application protocol configuration.",
          "oneOf": [
            {
              "title": "OAuth 2.0",
              "description": "OAuth2 protocol configuration.",
              "type": "object",
              "required": [
                "type"
              ],
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "oauth2"
                  ]
                },
                "allowed_scopes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Scopes to which this application can grant access. If this application references a resource server, this set of scopes must be a subset of the resource server's available scopes. If this application does not reference a resource server, then this application can only be used for authentication and thereby `scopes` must necessarily be empty.\n"
                },
                "client_id": {
                  "type": "string",
                  "description": "The client ID for this application. This is automatically set on creation. This field is output-only.\n",
                  "readOnly": true
                },
                "client_secret": {
                  "type": "string",
                  "description": "The client secret to authenticate as this application; typically, as a Basic Authorization header. This is automatically set on creation. This field is output-only. This field is present only when confidentiality is `confidential`.\n",
                  "readOnly": true
                },
                "confidentiality": {
                  "$ref": "#/$defs/Confidentiality"
                },
                "token_endpoint_auth_method": {
                  "$ref": "#/$defs/TokenEndpointAuthMethod"
                },
                "grant_type": {
                  "$ref": "#/$defs/GrantType"
                },
                "redirect_uris": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "A list of valid URIs to redirect the resource owner's user-agent to after completing its interaction with the authorization server. See https://datatracker.ietf.org/doc/html/rfc6749#section-3.1.2 for more information.\n"
                },
                "token_configuration": {
                  "$ref": "#/$defs/TokenConfiguration"
                },
                "pkce": {
                  "$ref": "#/$defs/PkceConfig"
                },
                "token_format": {
                  "description": "Allowed access token formats for this application.\ntoken type. Allowable values are:\n- `self_contained`: token in JWT format.\n- `referential`: Encoded token which requires /introspect\n   call in order to retrieve token claims.\n",
                  "type": "string",
                  "enum": [
                    "self_contained",
                    "referential"
                  ],
                  "default": "self_contained"
                }
              }
            },
            {
              "title": "OIDC",
              "description": "OIDC protocol configuration.",
              "type": "object",
              "required": [
                "type"
              ],
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "oidc"
                  ]
                },
                "allowed_scopes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Scopes to which this application can grant access. If this application references a resource server, this set of scopes must be a subset of the resource server's available scopes. If this application does not reference a resource server, then this application can only be used for authentication and thereby `scopes` must necessarily be empty. Note that OIDC requests may accept OpenID Connect standard scopes as well as resource server scopes, but the OpenID Connect scopes should not be defined on the application itself. Currently, the only OpenID Connect supported scope is `openid`.\n"
                },
                "client_id": {
                  "type": "string",
                  "description": "The client ID for this application. This is automatically set on creation. This field is output-only.\n",
                  "readOnly": true
                },
                "client_secret": {
                  "type": "string",
                  "description": "The client secret to authenticate as this application; typically, as a Basic Authorization header. This is automatically set on creation. This field is output-only. This field is present only when confidentiality is `confidential`.\n",
                  "readOnly": true
                },
                "confidentiality": {
                  "$ref": "#/$defs/Confidentiality"
                },
                "token_endpoint_auth_method": {
                  "$ref": "#/$defs/TokenEndpointAuthMethod"
                },
                "grant_type": {
                  "$ref": "#/$defs/GrantType"
                },
                "redirect_uris": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "A list of valid URIs to redirect the resource owner's user-agent to after completing its interaction with the authorization server. See https://datatracker.ietf.org/doc/html/rfc6749#section-3.1.2 for more information.\n"
                },
                "token_configuration": {
                  "$ref": "#/$defs/TokenConfiguration"
                },
                "pkce": {
                  "$ref": "#/$defs/PkceConfig"
                },
                "token_format": {
                  "$ref": "#/$defs/token_format"
                }
              }
            },
            {
              "$ref": "#/$defs/4"
            }
          ]
        }
      }
    },
    "Confidentiality": {
      "description": "The confidentiality of the client, as prescribed by OAuth 2.0 and\nOIDC. Confidentiality is based on a client's ability to authenticate\nsecurely with the authorization server (i.e., ability to\nmaintain the confidentiality of their client credentials). Allowable\nvalues are:\n- `confidential`: Clients capable of maintaining the confidentiality\n  of their credentials (e.g., client implemented on a secure server with\n  restricted access to the client credentials), or capable of secure\n  client authentication using other means.\n- `public`: Clients incapable of maintaining the confidentiality of their\n  credentials (e.g., clients executing on the device used by the\n  resource owner, such as an installed native application or a web\n  browser-based application), and incapable of secure client\n  authentication via any other means.\n",
      "type": "string",
      "enum": [
        "confidential",
        "public"
      ]
    },
    "GrantType": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "authorization_code",
          "client_credentials"
        ]
      },
      "description": "Grant types supported by this application's `token` endpoint. Allowable values\nare:\n- `authorization_code`: The authorization code grant type defined\n  in OAuth 2.0, Section 4.1. Namely, the client may authorize to the\n  `token` endpoint with a grant code which it obtains via the `authorize`\n  endpoint.\n- `client_credentials`: The client credentials grant type defined\n  in OAuth 2.0, Section 4.4. Namely, the client may authorize to the\n  `token` endpoint with a client credentials tuple of `client_id` and\n  `client_secret`.\n"
    },
    "PkceConfig": {
      "type": "string",
      "enum": [
        "disabled",
        "plain",
        "s256"
      ],
      "description": "PKCE code challenge methods supported for applications, as defined by\n[RFC-7636](https://datatracker.ietf.org/doc/html/rfc7636). Allowable values are:\n  - `disabled` : PKCE is disabled for this application. This is the default state if\n    the `pkce` field is left blank. Please note that public OIDC and OAuth2 configured\n    applications MUST enable PKCE support. Confidential clients can leave PKCE disabled\n    if they choose.\n  - `plain` : PKCE is enabled for this application. The server will correlate the `code_challenge` and\n    `code_verifier` between the `authorize` and `token` requests. In this configuration, those fields are\n    required to be identical. This is the lower security option for PKCE support and should only be used\n    by legacy clients, or clients that don't support `s256`.\n  - `s256` : PKCE is enabled for this application, and the server will correlate the `code_challenge` and\n    `code_verifier` between the `authorize` and `token` requests. In this configuration, those fields are\n    required to equate as follows: `code_challenge` = `base64url(sha256(ascii(code_verifier)))`. This is\n    the higher security option and should always be preferred if it is supported by the client.\n"
    },
    "TokenConfiguration": {
      "description": "Properties of a token issued for an application.",
      "type": "object",
      "required": [
        "expires_after"
      ],
      "properties": {
        "expires_after": {
          "type": "integer",
          "format": "uint32",
          "description": "Time after minting, in seconds, for which the token will be considered valid.\n",
          "minimum": 0
        },
        "token_signing_algorithm": {
          "type": "string",
          "enum": [
            "RS256"
          ],
          "description": "Signing algorithm to use for an application token. The only allowable value at present is `RS256`.\n",
          "default": "RS256"
        },
        "subject_field": {
          "type": "string",
          "enum": [
            "id",
            "email",
            "username"
          ],
          "description": "Property of a principal which is used to fill the subject of a token issued for this application.\n",
          "default": "id"
        }
      }
    },
    "TokenEndpointAuthMethod": {
      "description": "Indicator of the requested authentication method for the token endpoint.\nAllowable values are: - `client_secret_post`: The client uses the HTTP POST\nparameters\n   as defined in OAuth 2.0, Section 2.3.1. Namely, `client_id`\n   and `client_secret` are sent in the body of the POST request.\n- `client_secret_basic`: The client uses HTTP Basic as defined in\n   OAuth 2.0, Section 2.3.1. Namely, `client_id` and `client_secret`\n   are sent in the Basic Authorization header.\n- `none`: The `client_secret` is not part of the request body and there is no\nauthorization header.\n   This endpoint authentication method is only allowed if the application has\n`confidentiality` set to `confidential`.\n\nDeprecation Notice: This field is deprecated. The API will ignore the value\nof this field in requests. In responses, confidential applications will\nalways have `client_secret_basic` and public applications will always have\n`none`. On authentication, confidential applications may use both\n`client_secret_post` and `client_secret_basic`. Public applications may only\nuse `none`. **This field is scheduled for removal on August 1, 2023**\n",
      "type": "string",
      "deprecated": true,
      "enum": [
        "client_secret_basic",
        "client_secret_post",
        "none"
      ]
    }
  }
}