{ "components": { "responses": { "emptyResponse": { "description": "Empty responses are sent when, for example, resources are deleted. The HTTP status code for empty responses is\ntypically 201." }, "errorOAuth2BadRequest": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "Bad Request Error Response" }, "errorOAuth2Default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "Default Error Response" }, "errorOAuth2NotFound": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "Not Found Error Response" }, "identitySchemas": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/identitySchemas" } } }, "description": "List Identity JSON Schemas Response" }, "listCourierMessages": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/message" }, "type": "array" } } }, "description": "Paginated Courier Message List Response" }, "listIdentities": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/identity" }, "type": "array" } } }, "description": "Paginated Identity List Response" }, "listIdentitySessions": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/session" }, "type": "array" } } }, "description": "List Identity Sessions Response" }, "listMySessions": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/session" }, "type": "array" } } }, "description": "List My Session Response" }, "listOAuth2Clients": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/oAuth2Client" }, "type": "array" } } }, "description": "Paginated OAuth2 Client List Response" }, "listSessions": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/session" }, "type": "array" } } }, "description": "Session List Response\n\nThe response given when listing sessions in an administrative context." } }, "schemas": { "AccountExperienceColors": { "properties": { "ax_background_default": { "type": "string" }, "brand_100": { "type": "string" }, "brand_200": { "type": "string" }, "brand_300": { "type": "string" }, "brand_400": { "type": "string" }, "brand_50": { "type": "string" }, "brand_500": { "type": "string" }, "brand_600": { "type": "string" }, "brand_700": { "type": "string" }, "brand_800": { "type": "string" }, "brand_900": { "type": "string" }, "brand_950": { "type": "string" }, "button_identifier_background_default": { "type": "string" }, "button_identifier_background_hover": { "type": "string" }, "button_identifier_border_border_default": { "type": "string" }, "button_identifier_border_border_hover": { "type": "string" }, "button_identifier_foreground_default": { "type": "string" }, "button_identifier_foreground_hover": { "type": "string" }, "button_link_brand_brand": { "type": "string" }, "button_link_brand_brand_hover": { "type": "string" }, "button_link_default_primary": { "type": "string" }, "button_link_default_primary_hover": { "type": "string" }, "button_link_default_secondary": { "type": "string" }, "button_link_default_secondary_hover": { "type": "string" }, "button_link_disabled_disabled": { "type": "string" }, "button_primary_background_default": { "type": "string" }, "button_primary_background_disabled": { "type": "string" }, "button_primary_background_hover": { "type": "string" }, "button_primary_border_default": { "type": "string" }, "button_primary_border_disabled": { "type": "string" }, "button_primary_border_hover": { "type": "string" }, "button_primary_foreground_default": { "type": "string" }, "button_primary_foreground_disabled": { "type": "string" }, "button_primary_foreground_hover": { "type": "string" }, "button_secondary_background_default": { "type": "string" }, "button_secondary_background_disabled": { "type": "string" }, "button_secondary_background_hover": { "type": "string" }, "button_secondary_border_default": { "type": "string" }, "button_secondary_border_disabled": { "type": "string" }, "button_secondary_border_hover": { "type": "string" }, "button_secondary_foreground_default": { "type": "string" }, "button_secondary_foreground_disabled": { "type": "string" }, "button_secondary_foreground_hover": { "type": "string" }, "button_social_background_default": { "type": "string" }, "button_social_background_disabled": { "type": "string" }, "button_social_background_generic_provider": { "type": "string" }, "button_social_background_hover": { "type": "string" }, "button_social_border_default": { "type": "string" }, "button_social_border_disabled": { "type": "string" }, "button_social_border_generic_provider": { "type": "string" }, "button_social_border_hover": { "type": "string" }, "button_social_foreground_default": { "type": "string" }, "button_social_foreground_disabled": { "type": "string" }, "button_social_foreground_generic_provider": { "type": "string" }, "button_social_foreground_hover": { "type": "string" }, "checkbox_background_checked": { "type": "string" }, "checkbox_background_default": { "type": "string" }, "checkbox_border_checkbox_border_checked": { "type": "string" }, "checkbox_border_checkbox_border_default": { "type": "string" }, "checkbox_foreground_checked": { "type": "string" }, "checkbox_foreground_default": { "type": "string" }, "form_background_default": { "type": "string" }, "form_border_default": { "type": "string" }, "input_background_default": { "type": "string" }, "input_background_disabled": { "type": "string" }, "input_background_hover": { "type": "string" }, "input_border_default": { "type": "string" }, "input_border_disabled": { "type": "string" }, "input_border_focus": { "type": "string" }, "input_border_hover": { "type": "string" }, "input_foreground_disabled": { "type": "string" }, "input_foreground_primary": { "type": "string" }, "input_foreground_secondary": { "type": "string" }, "input_foreground_tertiary": { "type": "string" }, "interface_background_brand_primary": { "type": "string" }, "interface_background_brand_primary_hover": { "type": "string" }, "interface_background_brand_secondary": { "type": "string" }, "interface_background_brand_secondary_hover": { "type": "string" }, "interface_background_default_inverted": { "type": "string" }, "interface_background_default_inverted_hover": { "type": "string" }, "interface_background_default_none": { "type": "string" }, "interface_background_default_primary": { "type": "string" }, "interface_background_default_primary_hover": { "type": "string" }, "interface_background_default_secondary": { "type": "string" }, "interface_background_default_secondary_hover": { "type": "string" }, "interface_background_default_tertiary": { "type": "string" }, "interface_background_default_tertiary_hover": { "type": "string" }, "interface_background_disabled_disabled": { "type": "string" }, "interface_background_validation_danger": { "type": "string" }, "interface_background_validation_success": { "type": "string" }, "interface_background_validation_warning": { "type": "string" }, "interface_border_brand_brand": { "type": "string" }, "interface_border_default_inverted": { "type": "string" }, "interface_border_default_none": { "type": "string" }, "interface_border_default_primary": { "type": "string" }, "interface_border_disabled_disabled": { "type": "string" }, "interface_border_validation_danger": { "type": "string" }, "interface_border_validation_success": { "type": "string" }, "interface_border_validation_warning": { "type": "string" }, "interface_foreground_brand_on_primary": { "type": "string" }, "interface_foreground_brand_on_secondary": { "type": "string" }, "interface_foreground_brand_primary": { "type": "string" }, "interface_foreground_brand_secondary": { "type": "string" }, "interface_foreground_default_inverted": { "type": "string" }, "interface_foreground_default_primary": { "type": "string" }, "interface_foreground_default_secondary": { "type": "string" }, "interface_foreground_default_tertiary": { "type": "string" }, "interface_foreground_disabled_disabled": { "type": "string" }, "interface_foreground_disabled_on_disabled": { "type": "string" }, "interface_foreground_validation_danger": { "type": "string" }, "interface_foreground_validation_success": { "type": "string" }, "interface_foreground_validation_warning": { "type": "string" }, "ory_background_default": { "type": "string" }, "ory_border_default": { "type": "string" }, "ory_foreground_default": { "type": "string" }, "radio_background_checked": { "type": "string" }, "radio_background_default": { "type": "string" }, "radio_border_checked": { "type": "string" }, "radio_border_default": { "type": "string" }, "radio_foreground_checked": { "type": "string" }, "radio_foreground_default": { "type": "string" }, "toggle_background_checked": { "type": "string" }, "toggle_background_default": { "type": "string" }, "toggle_border_checked": { "type": "string" }, "toggle_border_default": { "type": "string" }, "toggle_foreground_checked": { "type": "string" }, "toggle_foreground_default": { "type": "string" }, "ui_100": { "type": "string" }, "ui_200": { "type": "string" }, "ui_300": { "type": "string" }, "ui_400": { "type": "string" }, "ui_50": { "type": "string" }, "ui_500": { "type": "string" }, "ui_600": { "type": "string" }, "ui_700": { "type": "string" }, "ui_800": { "type": "string" }, "ui_900": { "type": "string" }, "ui_950": { "type": "string" }, "ui_black": { "type": "string" }, "ui_danger": { "type": "string" }, "ui_success": { "type": "string" }, "ui_transparent": { "type": "string" }, "ui_warning": { "type": "string" }, "ui_white": { "type": "string" } }, "type": "object" }, "AdminIdentityImportCredentialsLookupSecret": { "description": "Create Identity and Import Lookup Secret Credentials", "properties": { "config": { "$ref": "#/components/schemas/AdminIdentityImportCredentialsLookupSecretConfig" } }, "type": "object" }, "AdminIdentityImportCredentialsLookupSecretConfig": { "description": "Create Identity and Import Lookup Secret Credentials Configuration", "properties": { "codes": { "description": "Codes is a list of \"lookup secret\" codes configured for the user.", "items": { "$ref": "#/components/schemas/identityCredentialsLookupSecretCode" }, "type": "array" } }, "type": "object" }, "AdminRevokeImportedApiKeyBody": { "description": "RevokeImportedApiKeyRequest revokes an imported API key by its key_id.", "properties": { "description": { "description": "Optional free-text explanation. Only allowed when reason is PRIVILEGE_WITHDRAWN.", "type": "string" }, "reason": { "$ref": "#/components/schemas/RevocationReason" } }, "type": "object" }, "AdminRevokeIssuedApiKeyBody": { "description": "RevokeIssuedApiKeyRequest revokes an issued API key by its key_id.", "properties": { "description": { "description": "Optional free-text explanation. Only allowed when reason is PRIVILEGE_WITHDRAWN.", "type": "string" }, "reason": { "$ref": "#/components/schemas/RevocationReason" } }, "type": "object" }, "AdminRotateIssuedApiKeyBody": { "description": "RotateIssuedApiKeyRequest is the request for AdminRotateIssuedApiKey.\n\nRotation is a custom method (AIP-136) that swaps an active key for a new\none with a fresh secret and key_id, then revokes the old key. It is not a\npartial update, so it does not carry an update_mask. Mutable fields use\npresence-based semantics: an absent field inherits from the old key, while\na present field (including an explicitly empty value) overrides.", "properties": { "ip_restriction": { "$ref": "#/components/schemas/IPRestriction" }, "metadata": { "description": "metadata for the new API key. Absent (nil) inherits from the old key;\npresent (including empty Struct) overrides.", "type": "object" }, "name": { "description": "name for the new API key. Absent (HasName() == false) inherits from the\nold key; present (including empty string) overrides.", "type": "string" }, "rate_limit_policy": { "$ref": "#/components/schemas/RateLimitPolicy" }, "scopes": { "description": "scopes for the new API key. Absent (nil slice) inherits from the old key;\npresent (including empty list) overrides.", "items": { "type": "string" }, "type": "array" }, "visibility": { "$ref": "#/components/schemas/KeyVisibility" } }, "type": "object" }, "AmountInCent": { "format": "int64", "type": "integer" }, "Any": { "additionalProperties": {}, "properties": { "@type": { "type": "string" } }, "type": "object" }, "Attribute": { "properties": { "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "AttributeFilter": { "properties": { "attribute": { "type": "string" }, "condition": { "enum": [ "equals", "not_equals", "contains", "not_contains", "regex", "not_regex", "set", "not_set" ], "type": "string", "x-go-enum-desc": "equals ConditionEquals\nnot_equals ConditionNotEquals\ncontains ConditionContains\nnot_contains ConditionNotContains\nregex ConditionRegex\nnot_regex ConditionNotRegex\nset ConditionSet\nnot_set ConditionNotSet" }, "value": { "type": "string" } }, "type": "object" }, "AttributesCountDatapoint": { "properties": { "count": { "description": "Count of the attribute value for given key", "format": "int64", "type": "integer" }, "name": { "description": "Name of the attribute value for given key", "type": "string" } }, "required": [ "name", "count" ], "type": "object" }, "AuthenticatorTransport": { "description": "Authenticators may implement various transports for communicating with clients. This enumeration defines hints as to\nhow clients might communicate with a particular authenticator in order to obtain an assertion for a specific\ncredential. Note that these hints represent the WebAuthn Relying Party's best belief as to how an authenticator may\nbe reached. A Relying Party will typically learn of the supported transports for a public key credential via\ngetTransports().\n\nSpecification: §5.8.4. Authenticator Transport Enumeration (https://www.w3.org/TR/webauthn/#enumdef-authenticatortransport)", "title": "AuthenticatorTransport represents the IDL enum with the same name.", "type": "string" }, "BatchCreateImportedApiKeysErrorCode": { "default": "BATCH_CREATE_IMPORTED_API_KEYS_ERROR_UNSPECIFIED", "description": "BatchCreateImportedApiKeysErrorCode classifies per-item batch import failures.\n\n - BATCH_CREATE_IMPORTED_API_KEYS_ERROR_UNSPECIFIED: No error (import succeeded)\n - BATCH_CREATE_IMPORTED_API_KEYS_ERROR_INVALID_ARGUMENT: The key data is malformed or missing required fields\n - BATCH_CREATE_IMPORTED_API_KEYS_ERROR_ALREADY_EXISTS: A key with this identifier already exists\n - BATCH_CREATE_IMPORTED_API_KEYS_ERROR_FAILED_PRECONDITION: State conflict prevents the import\n - BATCH_CREATE_IMPORTED_API_KEYS_ERROR_INTERNAL: Server error during import\n - BATCH_CREATE_IMPORTED_API_KEYS_ERROR_RESOURCE_EXHAUSTED: Per-tenant quota cap reached", "enum": [ "BATCH_CREATE_IMPORTED_API_KEYS_ERROR_UNSPECIFIED", "BATCH_CREATE_IMPORTED_API_KEYS_ERROR_INVALID_ARGUMENT", "BATCH_CREATE_IMPORTED_API_KEYS_ERROR_ALREADY_EXISTS", "BATCH_CREATE_IMPORTED_API_KEYS_ERROR_FAILED_PRECONDITION", "BATCH_CREATE_IMPORTED_API_KEYS_ERROR_INTERNAL", "BATCH_CREATE_IMPORTED_API_KEYS_ERROR_RESOURCE_EXHAUSTED" ], "type": "string" }, "BatchCreateImportedApiKeysRequest": { "description": "BatchCreateImportedApiKeysRequest imports multiple external API keys in one request.\nThe maximum batch size is 1000 keys.", "properties": { "requests": { "items": { "$ref": "#/components/schemas/ImportApiKeyRequest" }, "title": "Keys to import", "type": "array" } }, "type": "object" }, "BatchCreateImportedApiKeysResponse": { "description": "BatchCreateImportedApiKeysResponse returns per-item results and summary counters.", "properties": { "failure_count": { "format": "int32", "type": "integer" }, "results": { "items": { "$ref": "#/components/schemas/BatchCreateImportedApiKeysResult" }, "type": "array" }, "success_count": { "format": "int32", "type": "integer" } }, "type": "object" }, "BatchCreateImportedApiKeysResult": { "description": "BatchCreateImportedApiKeysResult contains the result for one key in a batch import request.", "properties": { "error_code": { "$ref": "#/components/schemas/BatchCreateImportedApiKeysErrorCode" }, "error_message": { "title": "Human-readable failure reason", "type": "string" }, "imported_api_key": { "$ref": "#/components/schemas/ImportedApiKey" }, "index": { "format": "int32", "title": "Zero-based index in request.requests", "type": "integer" } }, "type": "object" }, "BatchVerifyApiKeysRequest": { "properties": { "requests": { "items": { "$ref": "#/components/schemas/VerifyApiKeyRequest" }, "type": "array" } }, "type": "object" }, "BatchVerifyApiKeysResponse": { "properties": { "results": { "items": { "$ref": "#/components/schemas/VerifyApiKeyResponse" }, "type": "array" } }, "type": "object" }, "BillingPeriodBucket": { "properties": { "base_invoices": { "$ref": "#/components/schemas/Invoices" }, "billing_period": { "$ref": "#/components/schemas/TimeInterval" }, "usage_invoice": { "$ref": "#/components/schemas/invoice" } }, "type": "object" }, "CodeChannel": { "type": "string" }, "CreateInviteResponse": { "properties": { "all_invites": { "description": "A list of all invites for this resource", "items": { "$ref": "#/components/schemas/memberInvite" }, "type": "array" }, "created_invite": { "$ref": "#/components/schemas/memberInvite" } }, "required": [ "created_invite", "all_invites" ], "type": "object" }, "CreateProjectMemberInviteBody": { "description": "Create Project MemberInvite Request Body", "properties": { "invitee_email": { "description": "The email address to invite.", "type": "string" }, "role": { "default": "developer", "description": "The role the invited member will hold. Defaults to developer if omitted.\nOnly developer and viewer are valid; project ownership cannot be assigned via invite.\ndeveloper ProjectMemberRoleDeveloper\nviewer ProjectMemberRoleViewer", "enum": [ "developer", "viewer" ], "type": "string", "x-go-enum-desc": "developer ProjectMemberRoleDeveloper\nviewer ProjectMemberRoleViewer" } }, "required": [ "invitee_email" ], "type": "object" }, "CreateProjectNormalizedPayload": { "description": "Create project (normalized) request payload", "properties": { "account_experience_contact_url": { "description": "Holds the URL to the account experience's Contact page.\nThis governs the \"contact_url\" setting.", "type": "string" }, "account_experience_custom_translations": { "description": "The Account Experience's Custom Translations\n\nContains all Custom Translations for this project.", "items": { "$ref": "#/components/schemas/RevisionAccountExperienceCustomTranslation" }, "type": "array" }, "account_experience_default_locale": { "description": "Holds the default locale for the account experience.\nThis governs the \"default_locale\" setting.", "type": "string" }, "account_experience_enabled_locales": { "description": "The Account Experience's Enabled Locales\n\nThis governs the locales that are available in the account experience.\nThis governs the \"enabled_locales\" setting.", "items": { "type": "string" }, "type": "array" }, "account_experience_favicon_dark": { "description": "Holds the URL to the account experience's dark theme favicon (currently unused).\nThis governs the \"favicon_dark\" setting.", "type": "string" }, "account_experience_favicon_light": { "description": "Holds the URL to the account experience's favicon.\nThis governs the \"favicon_light\" setting.", "type": "string" }, "account_experience_hide_ory_branding": { "description": "Whether to hide the Ory branding badge on the account experience.\nThis governs the \"hide_ory_branding\" setting.", "type": "boolean" }, "account_experience_hide_registration_link": { "description": "Whether to hide the registration link on the account experience login card.\nThis governs the \"hide_registration_link\" setting.", "type": "boolean" }, "account_experience_locale_behavior": { "description": "Holds the URL to the account experience's language behavior.\n\nCan be one of:\n`respect_accept_language`: Respect the `Accept-Language` header.\n`force_default`: Force the default language.\nThis governs the \"locale_behavior\" setting.", "type": "string" }, "account_experience_logo_dark": { "description": "Holds the URL to the account experience's dark theme logo (currently unused).\nThis governs the \"logo_dark\" setting.", "type": "string" }, "account_experience_logo_light": { "description": "Holds the URL to the account experience's logo.\nThis governs the \"logo_light\" setting.", "type": "string" }, "account_experience_privacy_policy_url": { "description": "Holds the URL to the account experience's Privacy Policy page.\nThis governs the \"privacy_policy_url\" setting.", "type": "string" }, "account_experience_terms_of_service_url": { "description": "Holds the URL to the account experience's Terms of Service page.\nThis governs the \"terms_of_service_url\" setting.", "type": "string" }, "account_experience_theme_variables_dark": { "description": "Holds the URL to the account experience's dark theme variables.\nThis governs the \"theme_variables_dark\" setting.", "type": "string" }, "account_experience_theme_variables_light": { "description": "Holds the URL to the account experience's light theme variables.\nThis governs the \"theme_variables_light\" setting.", "type": "string" }, "created_at": { "description": "The Project's Revision Creation Date", "format": "date-time", "readOnly": true, "type": "string" }, "disable_account_experience_welcome_screen": { "description": "Whether to disable the account experience welcome screen, which is hosted under `/ui/welcome`.\nThis governs the \"disable_welcome_screen\" setting.", "type": "boolean" }, "enable_ax_v2": { "description": "Whether the new account experience is enabled and reachable.\nThis governs the \"enable_ax_v2\" setting.", "type": "boolean" }, "environment": { "description": "\nprod Production\nstage Staging\ndev Development", "enum": [ "prod", "stage", "dev" ], "type": "string", "x-go-enum-desc": "prod Production\nstage Staging\ndev Development" }, "home_region": { "description": "\neu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global", "enum": [ "eu-central", "asia-northeast", "us-east", "us-west", "eu", "asia", "us", "global" ], "type": "string", "x-go-enum-desc": "eu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global" }, "hydra_oauth2_allowed_top_level_claims": { "description": "A list of custom claims which are allowed to be added top level to the Access Token. They cannot override reserved claims.\n\nThis governs the \"oauth2.allowed_top_level_claims\" setting.", "items": { "type": "string" }, "type": "array" }, "hydra_oauth2_client_credentials_default_grant_allowed_scope": { "description": "Automatically grant authorized OAuth2 Scope in OAuth2 Client Credentials Flow.\n\nEach OAuth2 Client is allowed to request a predefined OAuth2 Scope (for example `read write`). If this option is enabled, the full\nscope is automatically granted when performing the OAuth2 Client Credentials flow.\n\nIf disabled, the OAuth2 Client has to request the scope in the OAuth2 request by providing the `scope` query parameter.\n\nSetting this option to true is common if you need compatibility with MITREid.\n\nThis governs the \"oauth2.client_credentials.default_grant_allowed_scope\" setting.", "type": "boolean" }, "hydra_oauth2_device_authorization_token_polling_interval": { "description": "Configures how often a non-interactive device should poll the\nOAuth 2.0 Device Authorization Grant token endpoint. Purely\ninformational — the value is reported to the device in the\n\"interval\" response field of the device authorization response.\nHydra defaults to 5s when this is left empty.\n\nThis is an Enterprise feature.\n\nThis governs the \"oauth2.device_authorization.token_polling_interval\" setting.", "example": "15s", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "hydra_oauth2_device_authorization_user_code_entropy_preset": { "description": "Picks a preset for the OAuth 2.0 Device Authorization Grant\nuser_code length and character set. \"high\" produces the longest\ncodes (most resistant to brute force); \"low\" the shortest (easiest\nfor the end user to read and enter). Leave empty to keep Hydra's\ndefault preset.\n\nThis is an Enterprise feature.\n\nThis governs the \"oauth2.device_authorization.user_code.entropy_preset\" setting.", "enum": [ "high", "medium", "low" ], "type": "string" }, "hydra_oauth2_exclude_not_before_claim": { "description": "Set to true if you want to omit the `nbf` (not valid before) claim in the access token.\n\nThis governs the \"oauth2.exclude_not_before_claim\" setting.", "type": "boolean" }, "hydra_oauth2_grant_jwt_iat_optional": { "description": "Configures if the issued at (`iat`) claim is required in the JSON Web Token (JWT) Profile for OAuth 2.0 Client Authentication and Authorization Grants (RFC7523).\n\nIf set to `false`, the `iat` claim is required. Set this value to `true` only after careful consideration.\n\nThis governs the \"oauth2.grant.jwt.iat_optional\" setting.", "type": "boolean" }, "hydra_oauth2_grant_jwt_jti_optional": { "description": "Configures if the JSON Web Token ID (`jti`) claim is required in the JSON Web Token (JWT) Profile for OAuth 2.0 Client Authentication and Authorization Grants (RFC7523).\n\nIf set to `false`, the `jti` claim is required. Set this value to `true` only after careful consideration.\n\nThis governs the \"oauth2.grant.jwt.jti_optional\" setting.", "type": "boolean" }, "hydra_oauth2_grant_jwt_max_ttl": { "default": "720h", "description": "Configures what the maximum age of a JWT assertion used in the JSON Web Token (JWT) Profile for OAuth 2.0 Client Authentication and Authorization Grants (RFC7523) can be.\n\nThis feature uses the `exp` claim and `iat` claim to calculate assertion age. Assertions exceeding the max age will be denied.\n\nUseful as a safety measure and recommended to keep below 720h.\n\nThis governs the \"oauth2.grant.jwt.max_ttl\" setting.", "example": "30m", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "hydra_oauth2_grant_jwt_omit_assertion_audience": { "description": "Configures whether the audience (`aud`) claim from the assertion JSON Web Token (JWT) in the JWT Profile for OAuth 2.0 Client Authentication and Authorization Grants (RFC7523) is omitted from the resulting access token.\n\nWhen set to `true` (the default for new projects), the audience values from the inbound assertion JWT are not granted in the access token. Set to `false` to copy the assertion audience into the access token (the legacy behavior).\n\nThis governs the \"oauth2.grant.jwt.omit_assertion_audience\" setting.", "type": "boolean" }, "hydra_oauth2_grant_refresh_token_rotation_grace_period": { "description": "Configures the OAuth2 Grant Refresh Token Rotation Grace Period\n\nIf set to `null` or `\"0s\"`, the graceful refresh token rotation is disabled.\n\nThis governs the \"oauth2.grant.refresh_token.rotation_grace_period\" setting.", "type": "string" }, "hydra_oauth2_grant_refresh_token_rotation_grace_reuse_count": { "description": "Configures the OAuth2 Grant Refresh Token Rotation Grace Reuse Count.\n\nThe maximum number of times a refresh token can be reused within the grace period.\nIf set to `null` or `0`, the limit is disabled.\n\nThis governs the \"oauth2.grant.refresh_token.rotation_grace_reuse_count\" setting.", "format": "int64", "type": "integer" }, "hydra_oauth2_mirror_top_level_claims": { "description": "Set to false if you don't want to mirror custom claims under 'ext'.\n\nThis governs the \"oauth2.mirror_top_level_claims\" setting.", "type": "boolean" }, "hydra_oauth2_pkce_enforced": { "description": "Configures whether PKCE should be enforced for all OAuth2 Clients.\n\nThis governs the \"oauth2.pkce.enforced\" setting.", "type": "boolean" }, "hydra_oauth2_pkce_enforced_for_public_clients": { "description": "Configures whether PKCE should be enforced for OAuth2 Clients without a client secret (public clients).\n\nThis governs the \"oauth2.pkce.enforced_for_public_clients\" setting.", "type": "boolean" }, "hydra_oauth2_preserve_ext_claims": { "description": "Set to true to keep custom claims that are not promoted to the top level in the 'ext' claim. Only applies when mirror_top_level_claims is false.\n\nThis governs the \"oauth2.preserve_ext_claims\" setting.", "type": "boolean" }, "hydra_oauth2_refresh_token_hook": { "description": "Sets the Refresh Token Hook Endpoint. If set this endpoint will be called during the OAuth2 Token Refresh grant update the OAuth2 Access Token claims.\n\nThis governs the \"oauth2.refresh_token_hook\" setting.", "type": "string" }, "hydra_oauth2_token_hook": { "description": "Sets the token hook endpoint for all grant types. If set it will be called while providing token to customize claims.\n\nThis governs the \"oauth2.token_hook.url\" setting.", "type": "string" }, "hydra_oauth2_token_prefix": { "description": "Sets a per-project Access Token, Refresh Token, and Authorization Code\nprefix. The literal \"%s\" is replaced at issuance time with the token kind:\n\"at\" (access token), \"rt\" (refresh token), or \"ac\" (authorization code).\nFor example, \"acme_%s_\" yields \"acme_at_…\", \"acme_rt_…\", and \"acme_ac_…\".\n\nMust be a fmt.Sprintf template with exactly one \"%s\" substitution. The\nrendered prefix may contain only ASCII letters, digits, and underscores —\nno other \"%\" directives (\"%d\", \"%%\", positional or width-flagged verbs),\nno hyphens, dots, slashes, whitespace, quotes, or non-ASCII characters.\nLeave empty to keep the default \"ory_%s_\" prefix.\n\nThis is an Enterprise feature.\n\nThis governs the \"oauth2.token_prefix\" setting.", "type": "string" }, "hydra_oidc_dynamic_client_registration_default_scope": { "description": "The OpenID Connect Dynamic Client Registration specification has no concept of whitelisting OAuth 2.0 Scope. If you want to expose Dynamic Client Registration, you should set the default scope enabled for newly registered clients. Keep in mind that users can overwrite this default by setting the \"scope\" key in the registration payload, effectively disabling the concept of whitelisted scopes.\n\nThis governs the \"oidc.dynamic_client_registration.default_scope\" setting.", "items": { "type": "string" }, "type": "array" }, "hydra_oidc_dynamic_client_registration_enabled": { "description": "Configures OpenID Connect Dynamic Client Registration.\n\nThis governs the \"oidc.dynamic_client_registration.enabled\" setting.", "type": "boolean" }, "hydra_oidc_subject_identifiers_pairwise_salt": { "description": "Configures OpenID Connect Discovery and overwrites the pairwise algorithm\n\nThis governs the \"oidc.subject_identifiers.pairwise_salt\" setting.", "type": "string" }, "hydra_oidc_subject_identifiers_supported_types": { "description": "Configures OpenID Connect Discovery and overwrites the list of Subject Identifier Algorithms to enable.\n\nThis governs the \"oidc.subject_identifiers.supported_types\" setting.", "items": { "type": "string" }, "type": "array" }, "hydra_secrets_cookie": { "description": "Configures the Ory Hydra Cookie Secret\n\nThis governs the \"secrets.cookie\" setting.", "items": { "type": "string" }, "type": "array" }, "hydra_secrets_pagination": { "description": "Configures the Ory Hydra Pagination Secret\n\nThis governs the \"secrets.pagination\" setting.", "items": { "type": "string" }, "type": "array" }, "hydra_secrets_system": { "description": "Configures the Ory Hydra System Secret\n\nThis governs the \"secrets.system\" setting.", "items": { "type": "string" }, "type": "array" }, "hydra_serve_cookies_same_site_legacy_workaround": { "description": "Configures the Ory Hydra Cookie Same Site Legacy Workaround\n\nThis governs the \"serve.cookies.same_site_legacy_workaround\" setting.", "type": "boolean" }, "hydra_serve_cookies_same_site_mode": { "description": "Configures the Ory Hydra Cookie Same Site Mode\n\nThis governs the \"serve.cookies.same_site_mode\" setting.", "type": "string" }, "hydra_strategies_access_token": { "default": "opaque", "description": "Defines access token type\n\nThis governs the \"strategies.access_token\" setting.\nopaque Oauth2AccessTokenStrategyOpaque\njwt Oauth2AccessTokenStrategyJwt", "enum": [ "opaque", "jwt" ], "type": "string", "x-go-enum-desc": "opaque Oauth2AccessTokenStrategyOpaque\njwt Oauth2AccessTokenStrategyJwt" }, "hydra_strategies_jwt_scope_claim": { "default": "list", "description": "Define the claim to use as the scope in the access token.\n\nThis governs the \"strategies.jwt.scope_claim\" setting.\n\nlist: The scope claim is an array of strings named `scope`: `{ \"scope\": [\"read\", \"write\"] }`\nstring: The scope claim is a space delimited list of strings named `scp`: `{ \"scp\": \"read write\" }`\nboth: The scope claim is both a space delimited list and an array of strings named `scope` and `scp`: `{ \"scope\": [\"read\", \"write\"], \"scp\": \"read write\" }`\nlist OAuth2JWTScopeClaimList\nstring OAuth2JWTScopeClaimString\nboth OAuth2JWTScopeClaimBoth", "enum": [ "list", "string", "both" ], "type": "string", "x-go-enum-desc": "list OAuth2JWTScopeClaimList\nstring OAuth2JWTScopeClaimString\nboth OAuth2JWTScopeClaimBoth" }, "hydra_strategies_scope": { "default": "wildcard", "description": "Defines how scopes are matched. For more details have a look at https://github.com/ory/fosite#scopes\n\nThis governs the \"strategies.scope\" setting.\nexact Oauth2ScopeStrategyExact\nwildcard Oauth2ScopeStrategyWildcard", "enum": [ "exact", "wildcard" ], "type": "string", "x-go-enum-desc": "exact Oauth2ScopeStrategyExact\nwildcard Oauth2ScopeStrategyWildcard" }, "hydra_ttl_access_token": { "default": "30m", "description": "This governs the \"ttl.access_token\" setting.", "example": "1h", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "hydra_ttl_auth_code": { "default": "720h", "description": "Configures how long refresh tokens are valid.\n\nSet to -1 for refresh tokens to never expire. This is not recommended!\n\nThis governs the \"ttl.auth_code\" setting.", "example": "30m", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "hydra_ttl_device_user_code": { "description": "Configures how long the device_code and user_code in the OAuth 2.0\nDevice Authorization Grant remain valid. Larger values mean more\ndatabase storage; shorter values mean users have less time to\ncomplete the second-device verification. Hydra defaults to 10m\nwhen this is left empty.\n\nThis is an Enterprise feature.\n\nThis governs the \"ttl.device_user_code\" setting.", "example": "30m", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "hydra_ttl_id_token": { "default": "30m", "description": "This governs the \"ttl.id_token\" setting.", "example": "1h", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "hydra_ttl_login_consent_request": { "default": "30m", "description": "Configures how long a user login and consent flow may take.\n\nThis governs the \"ttl.login_consent_request\" setting.", "example": "1h", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "hydra_ttl_refresh_token": { "default": "720h", "description": "Configures how long refresh tokens are valid.\n\nSet to -1 for refresh tokens to never expire. This is not recommended!\n\nThis governs the \"ttl.refresh_token\" setting.", "example": "30m", "pattern": "^(([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+|-1)$", "type": "string" }, "hydra_urls_consent": { "description": "Sets the OAuth2 Consent Endpoint URL of the OAuth2 User Login \u0026 Consent flow.\n\nDefaults to the Ory Account Experience if left empty.\n\nThis governs the \"urls.consent\" setting.", "type": "string" }, "hydra_urls_device_success": { "description": "Sets the URL the user is redirected to after successfully completing\nthe OAuth 2.0 Device Authorization Grant user verification step.\nDefaults to the Ory Account Experience fallback page if left empty.\n\nThis is an Enterprise feature.\n\nThis governs the \"urls.device.success\" setting.", "type": "string" }, "hydra_urls_device_verification": { "description": "Sets the URL of the user verification page for the OAuth 2.0 Device\nAuthorization Grant (RFC 8628). End users are redirected to this URL\nto enter the user_code shown on their device. Defaults to the Ory\nAccount Experience fallback page if left empty.\n\nThis is an Enterprise feature.\n\nThis governs the \"urls.device.verification\" setting.", "type": "string" }, "hydra_urls_error": { "description": "Sets the OAuth2 Error URL of the OAuth2 User Login \u0026 Consent flow.\n\nDefaults to the Ory Account Experience if left empty.\n\nThis governs the \"urls.error\" setting.", "type": "string" }, "hydra_urls_login": { "description": "Sets the OAuth2 Login Endpoint URL of the OAuth2 User Login \u0026 Consent flow.\n\nDefaults to the Ory Account Experience if left empty.\n\nThis governs the \"urls.login\" setting.", "type": "string" }, "hydra_urls_logout": { "description": "Sets the logout endpoint.\n\nDefaults to the Ory Account Experience if left empty.\n\nThis governs the \"urls.logout\" setting.", "type": "string" }, "hydra_urls_post_logout_redirect": { "description": "When an OAuth2-related user agent requests to log out, they will be redirected to this url afterwards per default.\n\nDefaults to the Ory Account Experience in development and your application in production mode when a custom domain is connected.\n\nThis governs the \"urls.post_logout_redirect\" setting.", "type": "string" }, "hydra_urls_registration": { "description": "Sets the OAuth2 Registration Endpoint URL of the OAuth2 User Login \u0026 Consent flow.\n\nDefaults to the Ory Account Experience if left empty.\n\nThis governs the \"urls.registration\" setting.", "type": "string" }, "hydra_urls_self_issuer": { "description": "This value will be used as the issuer in access and ID tokens. It must be specified and using HTTPS protocol, unless the development mode is enabled.\n\nOn the Ory Network it will be very rare that you want to modify this value. If left empty, it will default to the correct value for the Ory Network.\n\nThis governs the \"urls.self.issuer\" setting.", "type": "string" }, "hydra_webfinger_jwks_broadcast_keys": { "description": "A list of JSON Web Keys that should be exposed at that endpoint. This is usually the public key for verifying OpenID Connect ID Tokens. However, you might want to add additional keys here as well.\n\nThis governs the \"webfinger.jwks.broadcast_keys\" setting.", "items": { "type": "string" }, "type": "array" }, "hydra_webfinger_oidc_discovery_auth_url": { "description": "Configures OpenID Connect Discovery and overwrites the OAuth2 Authorization URL.\n\nThis governs the \"webfinger.oidc_discovery.auth_url\" setting.", "type": "string" }, "hydra_webfinger_oidc_discovery_client_registration_url": { "description": "Configures OpenID Connect Discovery and overwrites the OpenID Connect Dynamic Client Registration Endpoint.\n\nThis governs the \"webfinger.oidc_discovery.client_registration_url\" setting.", "type": "string" }, "hydra_webfinger_oidc_discovery_device_authorization_url": { "description": "Override the OAuth 2.0 Device Authorization Endpoint URL that is\nadvertised in the OpenID Connect discovery document\n(/.well-known/openid-configuration). Defaults to the project's\npublic base URL + /oauth2/device/auth.\n\nThis is an Enterprise feature.\n\nThis governs the \"webfinger.oidc_discovery.device_authorization_url\" setting.", "type": "string" }, "hydra_webfinger_oidc_discovery_jwks_url": { "description": "Configures OpenID Connect Discovery and overwrites the JWKS URL.\n\nThis governs the \"webfinger.oidc_discovery.jwks_url\" setting.", "type": "string" }, "hydra_webfinger_oidc_discovery_supported_claims": { "description": "Configures OpenID Connect Discovery and overwrites a list of supported claims to be broadcasted. Claim \"sub\" is always included.\n\nThis governs the \"webfinger.oidc_discovery.supported_claims\" setting.", "items": { "type": "string" }, "type": "array" }, "hydra_webfinger_oidc_discovery_supported_scope": { "description": "Configures OpenID Connect Discovery and overwrites the scope OAuth 2.0 Clients may request. Scope `offline`, `offline_access`, and `openid` are always included.\n\nThis governs the \"webfinger.oidc_discovery.supported_scope\" setting.", "items": { "type": "string" }, "type": "array" }, "hydra_webfinger_oidc_discovery_token_url": { "description": "Configures OpenID Connect Discovery and overwrites the OAuth2 Token URL.\n\nThis governs the \"webfinger.oidc_discovery.token_url\" setting.", "type": "string" }, "hydra_webfinger_oidc_discovery_userinfo_url": { "description": "Configures OpenID Connect Discovery and overwrites userinfo endpoint to be advertised at the OpenID Connect Discovery endpoint /.well-known/openid-configuration. Defaults to Ory Hydra's userinfo endpoint at /userinfo. Set this value if you want to handle this endpoint yourself.\n\nThis governs the \"webfinger.oidc_discovery.userinfo_url\" setting.", "type": "string" }, "id": { "description": "The revision ID.", "format": "uuid", "readOnly": true, "type": "string" }, "keto_namespace_configuration": { "description": "The Revisions' Keto Namespace Configuration\n\nThe string is a URL pointing to an OPL file with the configuration.\n\nThis governs the \"namespaces.location\" setting.", "type": "string" }, "keto_namespaces": { "$ref": "#/components/schemas/KetoNamespaces" }, "keto_secrets_pagination": { "description": "Configures Keto's pagination secrets.\n\nThis governs the \"secrets.pagination\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_cookies_same_site": { "description": "Configures the Ory Kratos Cookie SameSite Attribute\n\nThis governs the \"cookies.same_site\" setting.", "type": "string" }, "kratos_courier_channels": { "$ref": "#/components/schemas/revisionCourierChannels" }, "kratos_courier_delivery_strategy": { "default": "smtp", "description": "The delivery strategy to use when sending emails\n\nThis governs the \"courier.delivery_strategy\" setting.\n\n`smtp`: Use SMTP server\n`http`: Use the built in HTTP client to send the email to some remote service", "type": "string" }, "kratos_courier_http_request_config_auth_api_key_in": { "description": "The location of the API key to use in the HTTP email sending service's authentication\n\n`header`: Send the key value pair as a header\n`cookie`: Send the key value pair as a cookie\nThis governs the \"courier.http.request_config.auth.config.in\" setting.", "type": "string" }, "kratos_courier_http_request_config_auth_api_key_name": { "description": "The name of the API key to use in the HTTP email sending service's authentication\n\nThis governs the \"courier.http.request_config.auth.config.name\" setting.", "type": "string" }, "kratos_courier_http_request_config_auth_api_key_value": { "description": "The value of the API key to use in the HTTP email sending service's authentication\n\nThis governs the \"courier.http.request_config.auth.config.value\" setting.", "type": "string" }, "kratos_courier_http_request_config_auth_basic_auth_password": { "description": "The password to use for basic auth in the HTTP email sending service's authentication\n\nThis governs the \"courier.http.request_config.auth.config.password\" setting.", "type": "string" }, "kratos_courier_http_request_config_auth_basic_auth_user": { "description": "The user to use for basic auth in the HTTP email sending service's authentication\n\nThis governs the \"courier.http.request_config.auth.config.user\" setting.", "type": "string" }, "kratos_courier_http_request_config_auth_type": { "default": "empty (no authentication)", "description": "The authentication type to use while contacting the remote HTTP email sending service\n\nThis governs the \"courier.http.request_config.auth.type\" setting.\n\n`basic_auth`: Use Basic Authentication\n`api_key`: Use API Key Authentication in a header or cookie", "type": "string" }, "kratos_courier_http_request_config_body": { "description": "The Jsonnet template to generate the body to send to the remote HTTP email sending service\n\nShould be valid Jsonnet and base64 encoded\n\nThis governs the \"courier.http.request_config.body\" setting.", "type": "string" }, "kratos_courier_http_request_config_headers": { "description": "Any additional headers to send to the remote HTTP email sending service\n\nThis governs the \"courier.http.request_config.headers\" setting.", "type": "object" }, "kratos_courier_http_request_config_method": { "default": "POST", "description": "The http METHOD to use when calling the remote HTTP email sending service\n\nThis governs the \"courier.http.request_config.method\" setting.", "type": "string" }, "kratos_courier_http_request_config_url": { "description": "The URL of the remote HTTP email sending service\n\nThis governs the \"courier.http.request_config.url\" setting.", "type": "string" }, "kratos_courier_smtp_connection_uri": { "description": "Configures the Ory Kratos SMTP Connection URI\n\nThis governs the \"courier.smtp.connection_uri\" setting.", "type": "string" }, "kratos_courier_smtp_from_address": { "description": "Configures the Ory Kratos SMTP From Address\n\nThis governs the \"courier.smtp.from_address\" setting.", "type": "string" }, "kratos_courier_smtp_from_name": { "description": "Configures the Ory Kratos SMTP From Name\n\nThis governs the \"courier.smtp.from_name\" setting.", "type": "string" }, "kratos_courier_smtp_headers": { "description": "Configures the Ory Kratos SMTP Connection Headers\n\nThis governs the \"courier.smtp.headers\" setting.", "type": "object" }, "kratos_courier_smtp_local_name": { "description": "Configures the local_name to use in SMTP connections\n\nThis governs the \"courier.smtp.local_name\" setting.", "type": "string" }, "kratos_courier_templates_login_code_valid_email_body_html": { "description": "Configures the Ory Kratos Valid Login via Code Email Body HTML Template\n\nThis governs the \"courier.templates.login_code.valid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_login_code_valid_email_body_plaintext": { "description": "Configures the Ory Kratos Valid Login via Code Email Body Plaintext Template\n\nThis governs the \"courier.templates.login_code.valid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_login_code_valid_email_subject": { "description": "Configures the Ory Kratos Valid Login via Code Email Subject Template\n\nThis governs the \"courier.templates.login_code.valid.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_login_code_valid_sms_body_plaintext": { "description": "Configures the Ory Kratos Valid Login via Code SMS plain text body\n\nThis governs the \"courier.templates.login_code.valid.sms.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_recovery_code_invalid_email_body_html": { "description": "Configures the Ory Kratos Invalid Recovery via Code Email Body HTML Template\n\nThis governs the \"courier.templates.recovery_code.invalid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_recovery_code_invalid_email_body_plaintext": { "description": "Configures the Ory Kratos Invalid Recovery via Code Email Body Plaintext Template\n\nThis governs the \"courier.templates.recovery_code.invalid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_recovery_code_invalid_email_subject": { "description": "Configures the Ory Kratos Invalid Recovery via Code Email Subject Template\n\nThis governs the \"courier.templates.recovery_code.invalid.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_recovery_code_valid_email_body_html": { "description": "Configures the Ory Kratos Valid Recovery via Code Email Body HTML Template\n\nThis governs the \"courier.templates.recovery_code.valid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_recovery_code_valid_email_body_plaintext": { "description": "Configures the Ory Kratos Valid Recovery via Code Email Body Plaintext Template\n\nThis governs the \"courier.templates.recovery_code.valid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_recovery_code_valid_email_subject": { "description": "Configures the Ory Kratos Valid Recovery via Code Email Subject Template\n\nThis governs the \"courier.templates.recovery_code.valid.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_recovery_invalid_email_body_html": { "description": "Configures the Ory Kratos Invalid Recovery Email Body HTML Template\n\nThis governs the \"courier.templates.recovery.invalid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_recovery_invalid_email_body_plaintext": { "description": "Configures the Ory Kratos Invalid Recovery Email Body Plaintext Template\n\nThis governs the \"courier.templates.recovery.invalid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_recovery_invalid_email_subject": { "description": "Configures the Ory Kratos Invalid Recovery Email Subject Template\n\nThis governs the \"courier.templates.recovery.invalid.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_recovery_valid_email_body_html": { "description": "Configures the Ory Kratos Valid Recovery Email Body HTML Template\n\nThis governs the \"courier.templates.recovery.valid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_recovery_valid_email_body_plaintext": { "description": "Configures the Ory Kratos Valid Recovery Email Body Plaintext Template\n\nThis governs the \"courier.templates.recovery.valid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_recovery_valid_email_subject": { "description": "Configures the Ory Kratos Valid Recovery Email Subject Template\n\nThis governs the \"courier.templates.recovery.valid.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_registration_code_valid_email_body_html": { "description": "Configures the Ory Kratos Valid Registration via Code Email Body HTML Template\n\nThis governs the \"courier.templates.registration_code.valid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_registration_code_valid_email_body_plaintext": { "description": "Configures the Ory Kratos Valid Registration via Code Email Body Plaintext Template\n\nThis governs the \"courier.templates.registration_code.valid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_registration_code_valid_email_subject": { "description": "Configures the Ory Kratos Valid Registration via Code Email Subject Template\n\nThis governs the \"courier.templates.registration_code.valid.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_registration_code_valid_sms_body_plaintext": { "description": "Configures the Ory Kratos Valid Registration via Code SMS Body Plaintext Template\n\nThis governs the \"courier.templates.registration_code.valid.sms.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_verifiable_address_changed_email_body_html": { "description": "Configures the Ory Kratos Verifiable Address Changed Email Body HTML Template\n\nThis governs the \"courier.templates.verifiable_address_changed.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_verifiable_address_changed_email_body_plaintext": { "description": "Configures the Ory Kratos Verifiable Address Changed Email Body Plaintext Template\n\nThis governs the \"courier.templates.verifiable_address_changed.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_verifiable_address_changed_email_subject": { "description": "Configures the Ory Kratos Verifiable Address Changed Email Subject Template\n\nThis governs the \"courier.templates.verifiable_address_changed.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_verifiable_address_changed_sms_body_plaintext": { "description": "Configures the Ory Kratos Verifiable Address Changed SMS Body Plaintext Template\n\nThis governs the \"courier.templates.verifiable_address_changed.sms.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_verification_code_invalid_email_body_html": { "description": "Configures the Ory Kratos Invalid Verification via Code Email Body HTML Template\n\nThis governs the \"courier.templates.verification_code.invalid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_verification_code_invalid_email_body_plaintext": { "description": "Configures the Ory Kratos Invalid Verification via Code Email Body Plaintext Template\n\nThis governs the \"courier.templates.verification_code.invalid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_verification_code_invalid_email_subject": { "description": "Configures the Ory Kratos Invalid Verification via Code Email Subject Template\n\nThis governs the \"courier.templates.verification_code.invalid.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_verification_code_valid_email_body_html": { "description": "Configures the Ory Kratos Valid Verification via Code Email Body HTML Template\n\nThis governs the \"courier.templates.verification_code.valid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_verification_code_valid_email_body_plaintext": { "description": "Configures the Ory Kratos Valid Verification via Code Email Body Plaintext Template\n\nThis governs the \"courier.templates.verification_code.valid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_verification_code_valid_email_subject": { "description": "Configures the Ory Kratos Valid Verification via Code Email Subject Template\n\nThis governs the \"courier.templates.verification_code.valid.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_verification_code_valid_sms_body_plaintext": { "description": "Configures the Ory Kratos Valid Verification via Code SMS Body Plaintext\n\nThis governs the \"courier.templates.verification_code.valid.sms.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_verification_invalid_email_body_html": { "description": "Configures the Ory Kratos Invalid Verification Email Body HTML Template\n\nThis governs the \"courier.templates.verification.invalid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_verification_invalid_email_body_plaintext": { "description": "Configures the Ory Kratos Invalid Verification Email Body Plaintext Template\n\nThis governs the \"courier.templates.verification.invalid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_verification_invalid_email_subject": { "description": "Configures the Ory Kratos Invalid Verification Email Subject Template\n\nThis governs the \"courier.templates.verification.invalid.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_verification_valid_email_body_html": { "description": "Configures the Ory Kratos Valid Verification Email Body HTML Template\n\nThis governs the \"courier.templates.verification.valid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_verification_valid_email_body_plaintext": { "description": "Configures the Ory Kratos Valid Verification Email Body Plaintext Template\n\nThis governs the \"courier.templates.verification.valid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_verification_valid_email_subject": { "description": "Configures the Ory Kratos Valid Verification Email Subject Template\n\nThis governs the \"courier.templates.verification.valid.email.subject\" setting.", "type": "string" }, "kratos_feature_flags_cacheable_sessions": { "description": "Configures the Ory Kratos Session caching feature flag\n\nThis governs the \"feature_flags.cacheable_sessions\" setting.", "type": "boolean" }, "kratos_feature_flags_cacheable_sessions_max_age": { "description": "Configures the Ory Kratos Session caching max-age feature flag\n\nThis governs the \"feature_flags.cacheable_sessions_max_age\" setting.", "type": "string" }, "kratos_feature_flags_choose_recovery_address": { "description": "This governs the \"feature_flags.choose_recovery_address\" setting.", "type": "boolean" }, "kratos_feature_flags_faster_session_extend": { "description": "Configures the Ory Kratos Faster Session Extend setting\n\nIf enabled allows faster session extension by skipping the session lookup and returning 201 instead of 200.\nDisabling this feature will be deprecated in the future.\n\nThis governs the \"feature_flags.faster_session_extend\" setting.", "type": "boolean" }, "kratos_feature_flags_legacy_continue_with_verification_ui": { "description": "Always include show_verification_ui in continue_with\n\nIf true, restores the legacy behavior of always including `show_verification_ui` in the registration flow's `continue_with` when verification is enabled. If set to false, `show_verification_ui` is only set in `continue_with` if the `show_verification_ui` hook is used. This flag will be removed in the future.\n\nThis governs the \"feature_flags.legacy_continue_with_verification_ui\" setting.", "type": "boolean" }, "kratos_feature_flags_legacy_oidc_registration_node_group": { "description": "Controls whether the UI nodes in an OIDC registration flow have group \"oidc\" in case required fields are not returned by the OIDC provider.\n\nIf set to true, the UI nodes will have group \"oidc\" and the flow will be considered successful if the user completes the flow. This is the legacy behavior.\n\nThis governs the \"feature_flags.legacy_oidc_registration_node_group\" setting.", "type": "boolean" }, "kratos_feature_flags_legacy_require_verified_login_error": { "description": "Return a form error if the login identifier is not verified\n\nIf true, the login flow will return a form error if the login identifier is not verified, which restores legacy behavior. If this value is false, the `continue_with` array will contain a `show_verification_ui` hook instead.\n\nThis flag is deprecated and will be removed in the future.\n\nThis governs the \"feature_flags.legacy_require_verified_login_error\" setting.", "type": "boolean" }, "kratos_feature_flags_password_profile_registration_node_group": { "description": "Configures the group for the password method in the registration flow.\n\nIf true, it sets the password method group value to \"password\" if it is the only method available. This is the legacy behavior.\nIf false is, it sets the password method group value to \"default\".\n\nThis governs the \"feature_flags.password_profile_registration_node_group\" setting.", "type": "boolean" }, "kratos_feature_flags_refresh_login_choose_address": { "description": "Render an address picker on the code refresh login screen\n\nIf true, a code-strategy refresh (privileged re-authentication) login renders a \"Send code to \u003caddress\u003e\" button per available code address instead of re-asking for the identifier. The identity is already fixed by the active session, so re-entering the identifier is unnecessary. It is safe to toggle this back and forth.\n\nThis governs the \"feature_flags.refresh_login_choose_address\" setting.", "type": "boolean" }, "kratos_feature_flags_use_continue_with_transitions": { "description": "Configures the Ory Kratos Session use_continue_with_transitions flag\n\nThis governs the \"feature_flags.use_continue_with_transitions\" setting.", "type": "boolean" }, "kratos_identity_schemas": { "$ref": "#/components/schemas/projectRevisionIdentitySchemas" }, "kratos_oauth2_provider_headers": { "description": "Configures the OAuth2 Provider Integration HTTP Headers\n\nThis governs the \"oauth2_provider.headers\" setting.", "type": "object" }, "kratos_oauth2_provider_override_return_to": { "description": "Kratos OAuth2 Provider Override Return To\n\nEnabling this allows Kratos to set the return_to parameter automatically to the OAuth2 request URL on the login flow, allowing complex flows such as recovery to continue to the initial OAuth2 flow.\n\nThis governs the \"oauth2_provider.override_return_to\" setting.", "type": "boolean" }, "kratos_oauth2_provider_url": { "description": "The Revisions' OAuth2 Provider Integration URL\n\nThis governs the \"oauth2_provider.url\" setting.", "type": "string" }, "kratos_preview_default_read_consistency_level": { "description": "Configures the default read consistency level for identity APIs\n\nThe read consistency level determines the consistency guarantee for reads:\n\nstrong (slow): The read is guaranteed to return the most recent data committed at the start of the read.\neventual (very fast): The result will return data that is about 4.8 seconds old.\n\nSetting the default consistency level to `eventual` may cause regressions in the future as we add consistency\ncontrols to more APIs. Currently, the following APIs will be affected by this setting:\n\n`GET /admin/identities`\n\nDefaults to \"strong\" for new and existing projects. This feature is in preview. Use with caution.\nThis governs the \"preview.default_read_consistency_level\" setting.", "type": "string" }, "kratos_secrets_cipher": { "description": "Configures the Ory Kratos Cipher Secret\n\nThis governs the \"secrets.cipher\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_secrets_cookie": { "description": "Configures the Ory Kratos Cookie Secret\n\nThis governs the \"secrets.cookie\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_secrets_default": { "description": "Configures the Ory Kratos Default Secret\n\nThis governs the \"secrets.default\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_secrets_pagination": { "description": "Configures the Ory Kratos Pagination Secret\n\nThis governs the \"secrets.pagination\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_security_account_enumeration_mitigate": { "description": "Configures if account enumeration should be mitigated when using identifier first login.\n\nThis governs the \"security.account_enumeration.mitigate\" setting.", "type": "boolean" }, "kratos_selfservice_allowed_return_urls": { "description": "Configures the Ory Kratos Allowed Return URLs\n\nThis governs the \"selfservice.allowed_return_urls\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_selfservice_default_browser_return_url": { "description": "Configures the Ory Kratos Default Return URL\n\nThis governs the \"selfservice.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_error_ui_url": { "description": "Configures the Ory Kratos Error UI URL\n\nThis governs the \"selfservice.flows.error.ui_url\" setting.", "type": "string" }, "kratos_selfservice_flows_login_after_code_default_browser_return_url": { "description": "Configures the Ory Kratos Login After Code Default Return URL\n\nThis governs the \"selfservice.flows.login.after.code.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_login_after_default_browser_return_url": { "description": "Configures the Ory Kratos Login Default Return URL\n\nThis governs the \"selfservice.flows.login.after.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_login_after_lookup_secret_default_browser_return_url": { "description": "Configures the Ory Kratos Login After Lookup Secret Default Return URL\n\nThis governs the \"selfservice.flows.login.after.lookup_secret.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_login_after_oidc_default_browser_return_url": { "description": "Configures the Ory Kratos Login After OIDC Default Return URL\n\nThis governs the \"selfservice.flows.login.after.oidc.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_login_after_passkey_default_browser_return_url": { "description": "Configures the Ory Kratos Login After Passkey Default Return URL\n\nThis governs the \"selfservice.flows.login.after.passkey.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_login_after_password_default_browser_return_url": { "description": "Configures the Ory Kratos Login After Password Default Return URL\n\nThis governs the \"selfservice.flows.login.after.password.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_login_after_totp_default_browser_return_url": { "description": "Configures the Ory Kratos Login After TOTP Default Return URL\n\nThis governs the \"selfservice.flows.login.after.totp.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_login_after_webauthn_default_browser_return_url": { "description": "Configures the Ory Kratos Login After WebAuthn Default Return URL\n\nThis governs the \"selfservice.flows.login.after.webauthn.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_login_lifespan": { "description": "Configures the Ory Kratos Login Lifespan\n\nThis governs the \"selfservice.flows.login.lifespan\" setting.", "type": "string" }, "kratos_selfservice_flows_login_style": { "description": "Configures the Ory Kratos Login Flow Style\n\nThis governs the \"selfservice.flows.login.style\" setting.\nPossible values are \"unified\" and \"identifier_first\".", "type": "string" }, "kratos_selfservice_flows_login_ui_url": { "description": "Configures the Ory Kratos Login UI URL\n\nThis governs the \"selfservice.flows.login.ui_url\" setting.", "type": "string" }, "kratos_selfservice_flows_logout_after_default_browser_return_url": { "description": "Configures the Ory Kratos Logout Default Return URL\n\nThis governs the \"selfservice.flows.logout.after.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_recovery_after_default_browser_return_url": { "description": "Configures the Ory Kratos Recovery Default Return URL\n\nThis governs the \"selfservice.flows.recovery.after.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_recovery_enabled": { "description": "Configures the Ory Kratos Recovery Enabled Setting\n\nThis governs the \"selfservice.flows.recovery.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_flows_recovery_lifespan": { "description": "Configures the Ory Kratos Recovery Lifespan\n\nThis governs the \"selfservice.flows.recovery.lifespan\" setting.", "type": "string" }, "kratos_selfservice_flows_recovery_notify_unknown_recipients": { "description": "Configures whether to notify unknown recipients of a Ory Kratos recovery flow\n\nThis governs the \"selfservice.flows.recovery.notify_unknown_recipients\" setting.", "type": "boolean" }, "kratos_selfservice_flows_recovery_ui_url": { "description": "Configures the Ory Kratos Recovery UI URL\n\nThis governs the \"selfservice.flows.recovery.ui_url\" setting.", "type": "string" }, "kratos_selfservice_flows_recovery_use": { "description": "Configures the Ory Kratos Recovery strategy to use (\"link\" or \"code\")\n\nThis governs the \"selfservice.flows.recovery.use\" setting.\nlink SelfServiceMessageVerificationStrategyLink\ncode SelfServiceMessageVerificationStrategyCode", "enum": [ "link", "code" ], "type": "string", "x-go-enum-desc": "link SelfServiceMessageVerificationStrategyLink\ncode SelfServiceMessageVerificationStrategyCode" }, "kratos_selfservice_flows_registration_after_code_default_browser_return_url": { "description": "Configures the Ory Kratos Registration After Code Default Return URL\n\nThis governs the \"selfservice.flows.registration.after.code.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_registration_after_default_browser_return_url": { "description": "Configures the Ory Kratos Registration Default Return URL\n\nThis governs the \"selfservice.flows.registration.after.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_registration_after_oidc_default_browser_return_url": { "description": "Configures the Ory Kratos Registration After OIDC Default Return URL\n\nThis governs the \"selfservice.flows.registration.after.oidc.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_registration_after_passkey_default_browser_return_url": { "description": "Configures the Ory Kratos Registration After Passkey Default Return URL\n\nThis governs the \"selfservice.flows.registration.after.passkey.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_registration_after_password_default_browser_return_url": { "description": "Configures the Ory Kratos Registration After Password Default Return URL\n\nThis governs the \"selfservice.flows.registration.after.password.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_registration_after_webauthn_default_browser_return_url": { "description": "Configures the Ory Kratos Registration After Webauthn Default Return URL\n\nThis governs the \"selfservice.flows.registration.after.webauthn.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_registration_enable_legacy_one_step": { "description": "Disable two-step registration\n\nTwo-step registration is a significantly improved sign up flow and recommended\nwhen using more than one sign up methods. To revert to one-step registration,\nset this to `true`.\n\nThis governs the \"selfservice.flows.registration.enable_legacy_one_step\" setting.", "type": "boolean" }, "kratos_selfservice_flows_registration_enabled": { "description": "Configures the Whether Ory Kratos Registration is Enabled\n\nThis governs the \"selfservice.flows.registration.enabled\" setting.0", "type": "boolean" }, "kratos_selfservice_flows_registration_lifespan": { "description": "Configures the Ory Kratos Registration Lifespan\n\nThis governs the \"selfservice.flows.registration.lifespan\" setting.", "type": "string" }, "kratos_selfservice_flows_registration_login_hints": { "description": "Configures the Ory Kratos Registration Login Hints\n\nShows helpful information when a user tries to sign up with a duplicate account.\n\nThis governs the \"selfservice.flows.registration.login_hints\" setting.", "type": "boolean" }, "kratos_selfservice_flows_registration_ui_url": { "description": "Configures the Ory Kratos Registration UI URL\n\nThis governs the \"selfservice.flows.registration.ui_url\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_after_default_browser_return_url": { "description": "Configures the Ory Kratos Settings Default Return URL\n\nThis governs the \"selfservice.flows.settings.after.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_after_lookup_secret_default_browser_return_url": { "description": "Configures the Ory Kratos Settings Default Return URL After Updating Lookup Secrets\n\nThis governs the \"selfservice.flows.settings.after.lookup_secret.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_after_oidc_default_browser_return_url": { "description": "Configures the Ory Kratos Settings Default Return URL After Updating Social Sign In\n\nThis governs the \"selfservice.flows.settings.after.oidc.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_after_passkey_default_browser_return_url": { "description": "Configures the Ory Kratos Settings Default Return URL After Updating Passkey\n\nThis governs the \"selfservice.flows.settings.after.passkey.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_after_password_default_browser_return_url": { "description": "Configures the Ory Kratos Settings Default Return URL After Updating Passwords\n\nThis governs the \"selfservice.flows.settings.after.password.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_after_profile_default_browser_return_url": { "description": "Configures the Ory Kratos Settings Default Return URL After Updating Profiles\n\nThis governs the \"selfservice.flows.settings.after.profile.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_after_totp_default_browser_return_url": { "description": "Configures the Ory Kratos Settings Default Return URL After Updating TOTP\n\nThis governs the \"selfservice.flows.settings.after.totp.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_after_webauthn_default_browser_return_url": { "description": "Configures the Ory Kratos Settings Default Return URL After Updating WebAuthn\n\nThis governs the \"selfservice.flows.settings.after.webauthn.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_lifespan": { "description": "Configures the Ory Kratos Settings Lifespan\n\nThis governs the \"selfservice.flows.settings.lifespan\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_privileged_session_max_age": { "description": "Configures the Ory Kratos Settings Privileged Session Max Age\n\nThis governs the \"selfservice.flows.settings.privileged_session_max_age\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_required_aal": { "description": "Configures the Ory Kratos Settings Required AAL\n\nThis governs the \"selfservice.flows.settings.required_aal\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_ui_url": { "description": "Configures the Ory Kratos Settings UI URL\n\nThis governs the \"selfservice.flows.settings.ui_url\" setting.", "type": "string" }, "kratos_selfservice_flows_verification_after_default_browser_return_url": { "description": "Configures the Ory Kratos Verification Default Return URL\n\nThis governs the \"selfservice.flows.verification.after.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_verification_enabled": { "description": "Configures the Ory Kratos Verification Enabled Setting\n\nThis governs the \"selfservice.flows.verification.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_flows_verification_lifespan": { "description": "Configures the Ory Kratos Verification Lifespan\n\nThis governs the \"selfservice.flows.verification.lifespan\" setting.", "type": "string" }, "kratos_selfservice_flows_verification_notify_unknown_recipients": { "description": "Configures whether to notify unknown recipients of a Ory Kratos verification flow\n\nThis governs the \"selfservice.flows.verification.notify_unknown_recipients\" setting.", "type": "boolean" }, "kratos_selfservice_flows_verification_ui_url": { "description": "Configures the Ory Kratos Verification UI URL\n\nThis governs the \"selfservice.flows.verification.ui_url\" setting.", "type": "string" }, "kratos_selfservice_flows_verification_use": { "description": "Configures the Ory Kratos Strategy to use for Verification\n\nThis governs the \"selfservice.flows.verification.use\" setting.\nlink SelfServiceMessageVerificationStrategyLink\ncode SelfServiceMessageVerificationStrategyCode", "enum": [ "link", "code" ], "type": "string", "x-go-enum-desc": "link SelfServiceMessageVerificationStrategyLink\ncode SelfServiceMessageVerificationStrategyCode" }, "kratos_selfservice_methods_captcha_config_allowed_domains": { "description": "Configures the CAPTCHA allowed domains list\n\nThis governs the \"selfservice.methods.captcha.config.allowed_domains\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_selfservice_methods_captcha_config_byo": { "description": "Configures whether to use BYO or managed widget\n\nReach out to your account manager to enable this feature.\n\nThis governs the \"selfservice.methods.captcha.config.byo\" setting.", "type": "boolean" }, "kratos_selfservice_methods_captcha_config_cf_turnstile_byo_secret": { "description": "Configures the Cloudflare Turnstile site secret for Ory BYO CAPTCHA protection\n\nThe site secret is private and will be never be shared with the client. This key is write only and the value will not be returned in response to a read request.\n\nReach out to your account manager to enable this feature.\n\nThis governs the \"selfservice.methods.captcha.config.cf_turnstile.secret\" setting.", "type": "string" }, "kratos_selfservice_methods_captcha_config_cf_turnstile_byo_sitekey": { "description": "Configures the Cloudflare Turnstile site key for Ory BYO CAPTCHA protection\n\nThe site key is public and will be shared with the client.\n\nReach out to your account manager to enable this feature.\n\nThis governs the \"selfservice.methods.captcha.config.cf_turnstile.sitekey\" setting.", "type": "string" }, "kratos_selfservice_methods_captcha_config_cf_turnstile_secret": { "description": "Configures the Cloudflare Turnstile site secret for managed CAPTCHA protection\n\nThe site secret is private and will be never be shared with the client. This key is write only and the value will not be returned in response to a read request.\n\nReach out to your account manager to enable this feature.\n\nThis governs the \"selfservice.methods.captcha.config.cf_turnstile.secret\" setting.", "type": "string" }, "kratos_selfservice_methods_captcha_config_cf_turnstile_sitekey": { "description": "Configures the Cloudflare Turnstile site key for managed CAPTCHA protection\n\nThe site key is public and will be shared with the client.\n\nReach out to your account manager to enable this feature.\n\nThis governs the \"selfservice.methods.captcha.config.cf_turnstile.sitekey\" setting.", "type": "string" }, "kratos_selfservice_methods_captcha_config_legacy_inject_node": { "description": "Configures legacy CAPTCHA node injection behavior\n\nReach out to your account manager to enable this feature.\n\nThis governs the \"selfservice.methods.captcha.config.legacy_inject_node\" setting.", "type": "boolean" }, "kratos_selfservice_methods_captcha_enabled": { "description": "Configures the Ory Kratos Self-Service Methods' Captcha Enabled Setting\n\nReach out to your account manager to enable this feature.\n\nThis governs the \"selfservice.methods.captcha.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_code_config_lifespan": { "description": "Configures the Ory Kratos Code Method's lifespan\n\nThis governs the \"selfservice.methods.code.config.lifespan\" setting.", "type": "string" }, "kratos_selfservice_methods_code_config_max_submissions": { "description": "Configures the maximum number of attempts to submit a one-time code in kratos.\n\nThis governs the \"selfservice.methods.code.max_submissions\" setting.", "format": "int64", "type": "integer" }, "kratos_selfservice_methods_code_config_missing_credential_fallback_enabled": { "description": "Enables a fallback method required in certain legacy use cases.\n\nThis governs the \"selfservice.methods.code.config.missing_credential_fallback_enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_code_enabled": { "description": "Configures whether Ory Kratos Code Method is enabled\n\nThis governs the \"selfservice.methods.code.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_code_mfa_enabled": { "description": "Configures whether the code method can be used to fulfil MFA flows\n\nThis governs the \"selfservice.methods.code.mfa_enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_code_passwordless_enabled": { "description": "Configures whether Ory Kratos Passwordless should use the Code Method\n\nThis governs the \"selfservice.methods.code.passwordless_enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_code_passwordless_login_fallback_enabled": { "description": "This setting allows the code method to always login a user with code if they have registered with another authentication method such as password or social sign in.\n\nThis governs the \"selfservice.methods.code.passwordless_login_fallback_enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_deviceauthn_config_android_app_ids": { "description": "Configures the allow-list of Android app signing-certificate digests that a device key may be bound to.\n\nThis governs the \"selfservice.methods.deviceauthn.config.android_app_ids\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_selfservice_methods_deviceauthn_config_first_factor": { "description": "Configures whether device authentication may be used as the sole first factor.\n\nWhen enabled, a confirmed device key with PIN or platform user\nverification can complete an AAL2 login in a single submission, without a\npassword or code. Defaults to false, which keeps device keys usable only\nas a second factor (step-up).\n\nThis governs the \"selfservice.methods.deviceauthn.config.first_factor\" setting.", "type": "boolean" }, "kratos_selfservice_methods_deviceauthn_config_insecure_allow_relaxed_attestation": { "description": "Configures whether Ory Kratos Device authentication accepts relaxed attestations for testing\n\nOnly allowed on development projects and forced off otherwise. Keys enrolled\nunder relaxation are short-lived and refused once this is turned off.\n\nThis governs the \"selfservice.methods.deviceauthn.config.insecure_allow_relaxed_attestation\" setting.", "type": "boolean" }, "kratos_selfservice_methods_deviceauthn_config_ios_app_ids": { "description": "Configures the allow-list of Apple App IDs that a device key may be bound to.\n\nThis governs the \"selfservice.methods.deviceauthn.config.ios_app_ids\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_selfservice_methods_deviceauthn_config_ios_biometric_first_factor": { "description": "Configures whether an iOS biometric device key may be used as the sole first factor.\n\nApple App Attest cannot prove biometric gating, so iOS keys with\n\"platform\" user verification count as a first factor only with this\nexplicit opt-in. Android keys are unaffected, as their user verification\nis attestation-verified. Defaults to false.\n\nThis governs the \"selfservice.methods.deviceauthn.config.ios_biometric_first_factor\" setting.", "type": "boolean" }, "kratos_selfservice_methods_deviceauthn_config_pin_max_attempts": { "description": "Configures the number of consecutive wrong-PIN attempts before a device key is locked.\n\nDefaults to 5; must be between 1 and 10. Once locked, the key's\npin_secret is invalidated and the key can no longer be used to log in\nuntil the user rotates its secret through the fallback login.\n\nThis governs the \"selfservice.methods.deviceauthn.config.pin_max_attempts\" setting.", "format": "int64", "type": "integer" }, "kratos_selfservice_methods_deviceauthn_enabled": { "description": "Configures whether Ory Kratos Device authentication is enabled\n\nThis governs the \"selfservice.methods.deviceauthn.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_link_config_base_url": { "description": "Configures the Base URL which Recovery, Verification, and Login Links Point to\n\nIt is recommended to leave this value empty. It will be appropriately configured to the best matching domain\n(e.g. when using custom domains) automatically.\n\nThis governs the \"selfservice.methods.link.config.base_url\" setting.", "type": "string" }, "kratos_selfservice_methods_link_config_lifespan": { "description": "Configures the Ory Kratos Link Method's lifespan\n\nThis governs the \"selfservice.methods.link.config.lifespan\" setting.", "type": "string" }, "kratos_selfservice_methods_link_enabled": { "description": "Configures whether Ory Kratos Link Method is enabled\n\nThis governs the \"selfservice.methods.link.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_lookup_secret_enabled": { "description": "Configures whether Ory Kratos TOTP Lookup Secret is enabled\n\nThis governs the \"selfservice.methods.lookup_secret.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_oidc_config_base_redirect_uri": { "description": "Configures the Ory Kratos Third Party / OpenID Connect base redirect URI\n\nThis governs the \"selfservice.methods.oidc.config.base_redirect_uri\" setting.", "type": "string" }, "kratos_selfservice_methods_oidc_config_providers": { "$ref": "#/components/schemas/projectRevisionThirdPartyLoginProviders" }, "kratos_selfservice_methods_oidc_enable_auto_link_policy": { "description": "Configures whether Ory Kratos allows auto-linking of OIDC credentials without a subject\n\nThis governs the \"selfservice.methods.oidc.enable_auto_link_policy\" setting.", "type": "boolean" }, "kratos_selfservice_methods_oidc_enabled": { "description": "Configures whether Ory Kratos Third Party / OpenID Connect Login is enabled\n\nThis governs the \"selfservice.methods.oidc.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_passkey_config_rp_display_name": { "description": "Configures the Ory Kratos Passkey RP Display Name\n\nThis governs the \"selfservice.methods.passkey.config.rp.display_name\" setting.", "type": "string" }, "kratos_selfservice_methods_passkey_config_rp_id": { "description": "Configures the Ory Kratos Passkey RP ID\n\nThis governs the \"selfservice.methods.passkey.config.rp.id\" setting.", "type": "string" }, "kratos_selfservice_methods_passkey_config_rp_origins": { "description": "Configures the Ory Kratos Passkey RP Origins\n\nThis governs the \"selfservice.methods.passkey.config.rp.origins\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_selfservice_methods_passkey_enabled": { "description": "Configures whether Ory Kratos Passkey authentication is enabled\n\nThis governs the \"selfservice.methods.passkey.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_password_config_haveibeenpwned_enabled": { "description": "Configures whether Ory Kratos Password HIBP Checks is enabled\n\nThis governs the \"selfservice.methods.password.config.haveibeenpwned_enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_password_config_identifier_similarity_check_enabled": { "description": "Configures whether Ory Kratos Password should disable the similarity policy.\n\nThis governs the \"selfservice.methods.password.config.identifier_similarity_check_enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_password_config_ignore_network_errors": { "description": "Configures whether Ory Kratos Password Should ignore HIBPWND Network Errors\n\nThis governs the \"selfservice.methods.password.config.ignore_network_errors\" setting.", "type": "boolean" }, "kratos_selfservice_methods_password_config_max_breaches": { "description": "Configures Ory Kratos Password Max Breaches Detection\n\nThis governs the \"selfservice.methods.password.config.max_breaches\" setting.", "format": "int64", "type": "integer" }, "kratos_selfservice_methods_password_config_min_password_length": { "description": "Configures the minimum length of passwords.\n\nThis governs the \"selfservice.methods.password.config.min_password_length\" setting.", "format": "int64", "type": "integer" }, "kratos_selfservice_methods_password_enabled": { "description": "Configures whether Ory Kratos Password Method is enabled\n\nThis governs the \"selfservice.methods.password.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_profile_enabled": { "description": "Configures whether Ory Kratos Profile Method is enabled\n\nThis governs the \"selfservice.methods.profile.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_saml_config_providers": { "$ref": "#/components/schemas/projectRevisionSamlProviders" }, "kratos_selfservice_methods_saml_enabled": { "description": "Configures whether Ory Kratos SAML Login is enabled\n\nThis governs the \"selfservice.methods.saml.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_totp_config_issuer": { "description": "Configures Ory Kratos TOTP Issuer\n\nThis governs the \"selfservice.methods.totp.config.issuer\" setting.", "type": "string" }, "kratos_selfservice_methods_totp_enabled": { "description": "Configures whether Ory Kratos TOTP Method is enabled\n\nThis governs the \"selfservice.methods.totp.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_webauthn_config_passwordless": { "description": "Configures whether Ory Kratos Webauthn is used for passwordless flows\n\nThis governs the \"selfservice.methods.webauthn.config.passwordless\" setting.", "type": "boolean" }, "kratos_selfservice_methods_webauthn_config_rp_display_name": { "description": "Configures the Ory Kratos Webauthn RP Display Name\n\nThis governs the \"selfservice.methods.webauthn.config.rp.display_name\" setting.", "type": "string" }, "kratos_selfservice_methods_webauthn_config_rp_icon": { "description": "Configures the Ory Kratos Webauthn RP Icon\n\nThis governs the \"selfservice.methods.webauthn.config.rp.icon\" setting.\nDeprecated: This value will be ignored due to security considerations.", "type": "string" }, "kratos_selfservice_methods_webauthn_config_rp_id": { "description": "Configures the Ory Kratos Webauthn RP ID\n\nThis governs the \"selfservice.methods.webauthn.config.rp.id\" setting.", "type": "string" }, "kratos_selfservice_methods_webauthn_config_rp_origins": { "description": "Configures the Ory Kratos Webauthn RP Origins\n\nThis governs the \"selfservice.methods.webauthn.config.rp.origins\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_selfservice_methods_webauthn_enabled": { "description": "Configures whether Ory Kratos Webauthn is enabled\n\nThis governs the \"selfservice.methods.webauthn.enabled\" setting.", "type": "boolean" }, "kratos_session_cookie_persistent": { "description": "Configures the Ory Kratos Session Cookie Persistent Attribute\n\nThis governs the \"session.cookie.persistent\" setting.", "type": "boolean" }, "kratos_session_cookie_same_site": { "description": "Configures the Ory Kratos Session Cookie SameSite Attribute\n\nThis governs the \"session.cookie.same_site\" setting.", "type": "string" }, "kratos_session_lifespan": { "description": "Configures the Ory Kratos Session Lifespan\n\nThis governs the \"session.lifespan\" setting.", "type": "string" }, "kratos_session_whoami_required_aal": { "description": "Configures the Ory Kratos Session Whoami AAL requirement\n\nThis governs the \"session.whoami.required_aal\" setting.", "type": "string" }, "kratos_session_whoami_tokenizer_templates": { "$ref": "#/components/schemas/normalizedProjectRevisionTokenizerTemplates" }, "name": { "description": "The project's name.", "type": "string" }, "organizations": { "$ref": "#/components/schemas/organizations" }, "project_id": { "description": "The Revision's Project ID", "format": "uuid", "type": "string" }, "project_revision_hooks": { "$ref": "#/components/schemas/projectRevisionHooks" }, "scim_clients": { "$ref": "#/components/schemas/projectRevisionScimClients" }, "serve_admin_cors_allowed_origins": { "description": "Configures the CORS Allowed Origins on admin APIs\n\nThis governs the \"serve.admin.cors.allowed_origins\" setting.", "items": { "type": "string" }, "type": "array" }, "serve_admin_cors_enabled": { "description": "Enable CORS headers on all admin APIs\n\nThis governs the \"serve.admin.cors.enabled\" setting.", "type": "boolean" }, "serve_public_cors_allowed_origins": { "description": "Configures the CORS Allowed Origins on public APIs\n\nThis governs the \"serve.public.cors.allowed_origins\" setting.", "items": { "type": "string" }, "type": "array" }, "serve_public_cors_enabled": { "description": "Enable CORS headers on all public APIs\n\nThis governs the \"serve.public.cors.enabled\" setting.", "type": "boolean" }, "strict_security": { "description": "Whether the project should employ strict security measures. Setting this to true is recommended for going into production.", "type": "boolean" }, "talos_cache_enabled": { "description": "Talos cache enabled.\n\nWhen true, API key verification results are cached. Revoked keys may be\naccepted until the cached entry expires. When false, every verification\nreads the database and revocations take effect immediately.", "type": "boolean" }, "talos_cache_ttl": { "description": "Talos cache TTL controls how long API key verification results are cached.", "example": "5m", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "talos_credentials_api_keys_default_ttl": { "description": "Talos API keys default TTL.", "example": "1h", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "talos_credentials_api_keys_max_ttl": { "description": "Talos API keys max TTL.", "example": "24h", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "talos_credentials_api_keys_prefix_current": { "description": "Talos API keys prefix (current).", "type": "string" }, "talos_credentials_api_keys_prefix_public_current": { "description": "Talos API keys public prefix (current).", "type": "string" }, "talos_credentials_api_keys_prefix_public_retired": { "description": "Talos API keys public prefix (retired).\n\nPreviously active public API key prefixes kept for verification of outstanding tokens.\nThe first element of this list was the most recently retired active prefix.", "items": { "type": "string" }, "type": "array" }, "talos_credentials_api_keys_prefix_retired": { "description": "Talos API keys prefix (retired).\n\nPreviously active API key prefixes kept for verification of outstanding tokens.\nThe first element of this list was the most recently retired active prefix.", "items": { "type": "string" }, "type": "array" }, "talos_credentials_derived_tokens_default_ttl": { "description": "Talos derived tokens default TTL (applies to both JWT and macaroon tokens).", "example": "1h", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "talos_credentials_derived_tokens_jwt_signing_key_id": { "description": "Talos derived tokens JWT signing key ID (kid).", "type": "string" }, "talos_credentials_derived_tokens_jwt_signing_keys_urls": { "description": "Talos derived tokens JWT signing key URLs.", "items": { "type": "string" }, "type": "array" }, "talos_credentials_derived_tokens_macaroon_prefix_current": { "description": "Talos derived tokens macaroon prefix (current).", "type": "string" }, "talos_credentials_derived_tokens_macaroon_prefix_retired": { "description": "Talos derived tokens macaroon prefix (retired).\n\nPreviously active macaroon prefixes kept for verification of outstanding tokens.\nThe first element of this list was the most recently retired active prefix.", "items": { "type": "string" }, "type": "array" }, "talos_credentials_issuer": { "description": "Talos credentials issuer URL.", "type": "string" }, "talos_credentials_issuer_retired": { "description": "Talos credentials retired issuer URLs (deprecated).\n\nDeprecated: values-only view of talos_credentials_issuer_retired_entries,\nkept so already-released SDKs that decode this field as an array of strings\nkeep working. It is output only: reads are derived from the entries field\nand writes to it are ignored. Use talos_credentials_issuer_retired_entries\ninstead.", "items": { "type": "string" }, "readOnly": true, "type": "array" }, "talos_credentials_issuer_retired_entries": { "$ref": "#/components/schemas/talosRetiredValues" }, "talos_rate_limit_enabled": { "description": "Talos rate limit enabled.\n\nWhen true, server-side rate limiting is enforced for API key verifications.", "type": "boolean" }, "talos_secrets_hmac_current": { "description": "TalosSecretsHMACCurrent stores the current HMAC symmetric key as a\nplain secret string.", "type": "string" }, "talos_secrets_hmac_retired": { "description": "TalosSecretsHMACRetired stores previously active HMAC symmetric keys as an\narray of strings (deprecated).\n\nDeprecated: values-only view of talos_secrets_hmac_retired_entries, kept so\nalready-released SDKs that decode this field as an array of strings keep\nworking. It is output only and writes to it are ignored. HMAC secrets are\nserver-managed and redacted on output, so this field is always empty on the\nwire. Use talos_secrets_hmac_retired_entries instead.", "items": { "type": "string" }, "readOnly": true, "type": "array" }, "talos_secrets_hmac_retired_entries": { "$ref": "#/components/schemas/talosRetiredValues" }, "updated_at": { "description": "Last Time Project's Revision was Updated", "format": "date-time", "readOnly": true, "type": "string" }, "workspace_id": { "format": "uuid", "type": "string" } }, "required": [ "name", "environment" ], "type": "object" }, "CreateSubscriptionCommon": { "properties": { "currency": { "description": "\nusd USD\neur Euro", "enum": [ "usd", "eur" ], "type": "string", "x-go-enum-desc": "usd USD\neur Euro" }, "interval": { "description": "\nmonthly Monthly\nyearly Yearly", "enum": [ "monthly", "yearly" ], "type": "string", "x-go-enum-desc": "monthly Monthly\nyearly Yearly" }, "plan": { "type": "string" }, "return_to": { "type": "string" } }, "required": [ "plan", "interval" ], "type": "object" }, "CreateVerifiableCredentialRequestBody": { "properties": { "format": { "type": "string" }, "proof": { "$ref": "#/components/schemas/VerifiableCredentialProof" }, "types": { "items": { "type": "string" }, "type": "array" } }, "title": "CreateVerifiableCredentialRequestBody contains the request body to request a verifiable credential.", "type": "object" }, "CreateWorkspaceApiKeyBody": { "properties": { "expires_at": { "$ref": "#/components/schemas/Time" }, "name": { "description": "The API Key Name\n\nA descriptive name for the API key.", "type": "string" } }, "required": [ "name" ], "type": "object" }, "CreateWorkspaceMemberInviteBody": { "description": "Create Workspace Invite Request Body", "properties": { "invitee_email": { "description": "A email to invite", "type": "string" }, "role": { "description": "The role the user will have in the workspace\nowner WorkspaceMemberRoleOwner\ndeveloper WorkspaceMemberRoleDeveloper\nviewer WorkspaceMemberRoleViewer", "enum": [ "owner", "developer", "viewer" ], "type": "string", "x-go-enum-desc": "owner WorkspaceMemberRoleOwner\ndeveloper WorkspaceMemberRoleDeveloper\nviewer WorkspaceMemberRoleViewer" } }, "required": [ "invitee_email", "role" ], "type": "object" }, "DefaultError": { "description": "From https://go.dev/wiki/CodeReviewComments#receiver-type:\n\u003e Can function or methods, either concurrently or when called from this method, be mutating the receiver? A value type creates a copy of the receiver when the method is invoked, so outside updates will not be applied to this receiver. If changes must be visible in the original receiver, the receiver must be a pointer.\n\u003e If the receiver is a struct, array or slice and any of its elements is a pointer to something that might be mutating,\n\u003e prefer a pointer receiver, as it will make the intention clearer to the reader.\n\u003e Don’t mix receiver types. Choose either pointers or struct types for all available methods.", "title": "DefaultError is not safe to shallow copy because it contains\nfields which are not value types, e.g. maps.\nA shallow copy would inadvertently share these underlying fields,\nleading to incorrect behavior and data races in a concurrent context.\nConsequently, all methods take the type by pointer and not by value." }, "DeriveTokenRequest": { "properties": { "algorithm": { "$ref": "#/components/schemas/TokenAlgorithm" }, "credential": { "title": "The API key secret (issued or imported) to derive a token from", "type": "string" }, "custom_claims": { "description": "custom_claims is a JSON object whose entries are merged into the JWT\npayload (or macaroon caveats) at signing time. Reserved JWT claims\n(iss, sub, aud, exp, nbf, iat, jti) are rejected. Total serialized\nsize is capped at 4KB.", "type": "object" }, "scopes": { "items": { "type": "string" }, "type": "array" }, "ttl": { "description": "ttl sets the expiry as a duration from now. Encoded as a\ngoogle.protobuf.Duration (string ending in \"s\", e.g. \"3600s\").\nAccepted bounds: 1s to 315360000s (~10 years). If unset or zero, the\nproject default TTL applies.\nFor convenience, the server also accepts Go-style duration strings\n(\"24h\", \"30m\", \"1h30m\") and an extended unit set (\"1d\", \"1w\", \"1mo\",\n\"1y\"; approximations: 1mo = 30d, 1y = 365d). Clients should prefer\nthe standard Duration encoding for portability.", "type": "string" } }, "title": "Token derivation messages", "type": "object" }, "DeriveTokenResponse": { "properties": { "token": { "$ref": "#/components/schemas/Token" } }, "type": "object" }, "DeviceAuthnKey": { "description": "Represents a hardware-backed signing key enrolled from a mobile device.\nThe private key resides inside the device and never exists on the server.\n\nTo list the identity's enrolled keys, fetch a settings flow: each key's\nremove button (a `ui.nodes` entry named `deviceauthn_remove` in group\n`deviceauthn`) carries the key, with its PIN state redacted, in the node\nlabel's `context`.", "properties": { "attestation": { "$ref": "#/components/schemas/deviceAuthnAttestation" }, "client_key_id": { "description": "The key's stable id, unique per identity. Submit it as the\n`client_key_id` when logging in with the key, deleting it, or rotating\nits pin_secret.\n\nThe device can also compute the id without reading it back from the\nserver: it is the lowercase-hex SHA-256 of `public_key` (the key's\nPKIX, ASN.1 DER encoding). Keys enrolled before the server derived the\nid keep their original client-chosen value, so prefer reading this\nfield over recomputing it for older keys.", "type": "string" }, "created_at": { "description": "When the key was enrolled. Only used for troubleshooting and UI.", "format": "date-time", "type": "string" }, "device_name": { "description": "A human-readable name for the device, helping the user tell this key\napart from others.", "type": "string" }, "device_type": { "$ref": "#/components/schemas/DeviceType" }, "pin": { "$ref": "#/components/schemas/PINConfig" }, "public_key": { "description": "The device's public key (an elliptic-curve key on P-224, P-256, P-384,\nor P-521 in version 1) in PKIX, ASN.1 DER (SubjectPublicKeyInfo) form,\nbase64-encoded. Signatures are verified against this key.", "format": "byte", "type": "string" }, "relaxed_attestation_expires_at": { "description": "Set only when the key's attestation chain was accepted under relaxed\nrules (software roots, expired certificates, software security level)\nrather than strict hardware attestation. Such keys are refused at login\nafter this time, or immediately once relaxed attestation is turned off.\nAbsent for hardware-attested keys that pass strict validation.", "format": "date-time", "type": "string" }, "state": { "$ref": "#/components/schemas/KeyState" }, "user_verification": { "$ref": "#/components/schemas/UserVerification" }, "version": { "description": "The cryptography version of the key. Version 1 uses ECDSA with SHA-256\non an elliptic curve (P-224, P-256, P-384, or P-521); further versions\nare reserved for future signature suites.", "format": "int64", "type": "integer" } }, "title": "An enrolled device authentication (DeviceAuthn) key.", "type": "object" }, "DeviceType": { "description": "\"Android\" and \"iOS\" use different attestation and signature encodings.", "enum": [ "Android", "iOS" ], "title": "DeviceType is the platform the key was enrolled on.", "type": "string", "x-enum-varnames": [ "ANDROID", "IOS" ] }, "DeviceUserAuthRequest": { "properties": { "challenge": { "description": "ID is the identifier (\"device challenge\") of the device grant request. It is used to\nidentify the session.", "type": "string" }, "client": { "$ref": "#/components/schemas/oAuth2Client" }, "handled_at": { "$ref": "#/components/schemas/nullTime" }, "request_url": { "description": "RequestURL is the original Device Authorization URL requested.", "type": "string" }, "requested_access_token_audience": { "description": "RequestedAudience contains the access token audience as requested by the OAuth 2.0 Client.", "items": { "type": "string" }, "type": "array" }, "requested_scope": { "description": "RequestedScope contains the OAuth 2.0 Scope requested by the OAuth 2.0 Client.", "items": { "type": "string" }, "type": "array" } }, "required": [ "challenge" ], "title": "Contains information on an ongoing device grant request.", "type": "object" }, "Duration": { "description": "A Duration represents the elapsed time between two instants\nas an int64 nanosecond count. The representation limits the\nlargest representable duration to approximately 290 years.", "format": "int64", "type": "integer" }, "Enumerated": { "format": "int64", "title": "An Enumerated is represented as a plain int.", "type": "integer" }, "GenericOIDCProvider": { "properties": { "client_id": { "description": "The client_id of the OIDC provider.", "type": "string" }, "client_secret": { "description": "The client_secret of the OIDC provider.", "type": "string" }, "issuer_url": { "description": "The issuer URL of the OIDC provider.", "type": "string" } }, "required": [ "issuer_url", "client_id", "client_secret" ], "type": "object" }, "GenericUsage": { "properties": { "additional_price": { "$ref": "#/components/schemas/Money" }, "included_usage": { "description": "IncludedUsage is the number of included items.", "format": "int64", "type": "integer" } }, "required": [ "included_usage", "additional_price" ], "title": "GenericUsage is the generic usage type that can be used for any feature.", "type": "object" }, "GetJWKSResponse": { "properties": { "jwks": { "description": "A JSON Web Key Set (RFC 7517). Contains a single field `keys`, an array of JWK objects.", "properties": { "keys": { "description": "Array of JWK objects. Each key has at minimum `kty` (key type) and `kid` (key ID) plus key-type-specific material (e.g. `x`/`crv` for OKP/Ed25519, `n`/`e` for RSA).", "items": { "properties": { "alg": { "type": "string" }, "crv": { "type": "string" }, "e": { "type": "string" }, "kid": { "type": "string" }, "kty": { "type": "string" }, "n": { "type": "string" }, "use": { "type": "string" }, "x": { "type": "string" }, "y": { "type": "string" } }, "required": [ "kty", "kid" ], "type": "object" }, "type": "array" } }, "required": [ "keys" ], "type": "object" } }, "type": "object" }, "ID": { "format": "int64", "type": "integer" }, "IPRestriction": { "description": "IPRestriction defines IP-based access controls for an API key.\nWhen allowed_cidrs is non-empty, only requests from IPs matching at least one\nCIDR range are permitted. Empty allowed_cidrs means no IP restriction (all IPs allowed).\nIP restrictions apply to root API key and imported key verification only;\nderived tokens (JWT/macaroon) are stateless and not subject to IP checks.", "properties": { "allowed_cidrs": { "description": "allowed_cidrs is a list of CIDR ranges that are allowed to use this key.\nSupports both IPv4 (e.g., \"10.0.0.0/8\") and IPv6 (e.g., \"2001:db8::/32\").\nIf empty, all IPs are allowed (no restriction).", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "ImportApiKeyRequest": { "description": "Example:\n {\n \"raw_key\": \"imported-key-EXAMPLE-not-a-real-secret\",\n \"name\": \"Example imported key\",\n \"actor_id\": \"payment-processor\",\n \"scopes\": [\"read\", \"write\"],\n \"ttl\": \"8760h\", // 1 year (also accepts: 31536000s)\n \"metadata\": {\"source\": \"example-provider\", \"environment\": \"staging\"}\n }", "properties": { "actor_id": { "description": "actor_id is the identifier of the entity that owns this imported key.\nRequired so every imported key is traceable to an actor for revocation and\naudit queries.", "type": "string" }, "ip_restriction": { "$ref": "#/components/schemas/IPRestriction" }, "metadata": { "description": "metadata is a free-form JSON object for caller-defined attributes (e.g.,\nsource, environment, tags). Values may be strings, numbers, booleans,\narrays, objects, or null. Total serialized size is capped at 4KB.\nAIP-148 metadata field.", "type": "object" }, "name": { "title": "Human-readable name (REQUIRED)", "type": "string" }, "rate_limit_policy": { "$ref": "#/components/schemas/RateLimitPolicy" }, "raw_key": { "title": "The actual key string to import (REQUIRED)", "type": "string" }, "request_id": { "title": "Client-controlled idempotency key (AIP-155)", "type": "string" }, "scopes": { "items": { "type": "string" }, "title": "Scopes for the imported key (OPTIONAL)", "type": "array" }, "ttl": { "description": "ttl sets the expiry as a duration from now. Encoded as a\ngoogle.protobuf.Duration (string ending in \"s\", e.g. \"3600s\").\nAccepted bounds: 1s to 315360000s (~10 years). If unset or zero, the\nproject default TTL applies.\nFor convenience, the server also accepts Go-style duration strings\n(\"24h\", \"30m\", \"1h30m\") and an extended unit set (\"1d\", \"1w\", \"1mo\",\n\"1y\"; approximations: 1mo = 30d, 1y = 365d). Clients should prefer\nthe standard Duration encoding for portability.", "type": "string" }, "visibility": { "$ref": "#/components/schemas/KeyVisibility" } }, "title": "ImportApiKeyRequest imports an external HMAC-based API key", "type": "object" }, "ImportedApiKey": { "description": "ImportedApiKey represents an API key imported from an external system.\nThe raw key is hashed (SHA-512/256) and stored. The original key is never retained.", "properties": { "actor_id": { "type": "string" }, "create_time": { "format": "date-time", "type": "string" }, "expire_time": { "format": "date-time", "type": "string" }, "ip_restriction": { "$ref": "#/components/schemas/IPRestriction" }, "key_id": { "title": "SHA-512/256 hash of credential", "type": "string" }, "last_used_time": { "format": "date-time", "type": "string" }, "metadata": { "description": "metadata is a free-form JSON object for caller-defined attributes\n(e.g., source, environment, tags). Values may be strings, numbers,\nbooleans, arrays, objects, or null. Total serialized size is capped\nat 4KB. AIP-148 metadata field.", "type": "object" }, "name": { "type": "string" }, "rate_limit_policy": { "$ref": "#/components/schemas/RateLimitPolicy" }, "revocation_description": { "description": "revocation_description provides free-form context for a revocation.\nOnly set when revocation_reason is PRIVILEGE_WITHDRAWN.\nJSON API change: field was formerly revocation_reason_text. Field number 13\nis unchanged so the change is wire-compatible for binary proto encoding.", "type": "string" }, "revocation_reason": { "$ref": "#/components/schemas/RevocationReason" }, "scopes": { "items": { "type": "string" }, "type": "array" }, "status": { "$ref": "#/components/schemas/KeyStatus" }, "update_time": { "format": "date-time", "type": "string" }, "visibility": { "$ref": "#/components/schemas/KeyVisibility" } }, "type": "object" }, "InvoiceDataV1": { "properties": { "billing_period": { "$ref": "#/components/schemas/TimeInterval" }, "currency": { "description": "The currency of the invoice.", "readOnly": true, "type": "string" }, "deleted": { "description": "Deleted is true if the invoice has been soft-deleted.", "readOnly": true, "type": "boolean" }, "items": { "description": "The items that are part of this invoice.", "items": { "$ref": "#/components/schemas/LineItemV1" }, "readOnly": true, "type": "array" }, "plan": { "description": "The plan that this invoice is based on, in the format \"Name@version\".", "readOnly": true, "type": "string" }, "stripe_invoice_item": { "type": "string" }, "stripe_invoice_status": { "$ref": "#/components/schemas/InvoiceStatus" }, "stripe_link": { "description": "An optional link to the invoice on Stripe.", "readOnly": true, "type": "string" }, "subtitle": { "description": "The subtitle of the invoice.", "readOnly": true, "type": "string" }, "tax": { "$ref": "#/components/schemas/TaxLineItem" }, "title": { "description": "The title of the invoice.", "readOnly": true, "type": "string" }, "total_in_cent": { "$ref": "#/components/schemas/AmountInCent" } }, "required": [ "title", "currency", "total_in_cent", "billing_period", "items" ], "type": "object" }, "InvoiceStatus": { "description": "The status of the invoice, one of `draft`, `open`, `paid`, `uncollectible`, or `void`. [Learn more](https://stripe.com/docs/billing/invoices/workflow#workflow-overview)", "type": "string" }, "Invoices": { "items": { "$ref": "#/components/schemas/invoice" }, "type": "array" }, "IssueApiKeyRequest": { "properties": { "actor_id": { "type": "string" }, "ip_restriction": { "$ref": "#/components/schemas/IPRestriction" }, "metadata": { "description": "metadata is a free-form JSON object for caller-defined attributes\n(e.g., source, environment, tags). Values may be strings, numbers,\nbooleans, arrays, objects, or null. Total serialized size is capped\nat 4KB. AIP-148 metadata field.", "type": "object" }, "name": { "type": "string" }, "rate_limit_policy": { "$ref": "#/components/schemas/RateLimitPolicy" }, "request_id": { "title": "Client-controlled idempotency key (AIP-155)", "type": "string" }, "scopes": { "items": { "type": "string" }, "type": "array" }, "ttl": { "description": "ttl sets the expiry as a duration from now. Encoded as a\ngoogle.protobuf.Duration (string ending in \"s\", e.g. \"3600s\").\nAccepted bounds: 1s to 315360000s (~10 years). If unset or zero, the\nproject default TTL applies.\nFor convenience, the server also accepts Go-style duration strings\n(\"24h\", \"30m\", \"1h30m\") and an extended unit set (\"1d\", \"1w\", \"1mo\",\n\"1y\"; approximations: 1mo = 30d, 1y = 365d). Clients should prefer\nthe standard Duration encoding for portability.", "type": "string" }, "visibility": { "$ref": "#/components/schemas/KeyVisibility" } }, "type": "object" }, "IssueApiKeyResponse": { "properties": { "issued_api_key": { "$ref": "#/components/schemas/IssuedApiKey" }, "secret": { "title": "Only returned on creation", "type": "string" } }, "type": "object" }, "IssuedApiKey": { "description": "IssuedApiKey represents an API key issued (generated) by Talos.\nRoot keys are opaque v1 format tokens stored in the database.\nDerived tokens (JWT/Macaroon) are created via DeriveToken and are stateless (not stored).", "properties": { "actor_id": { "type": "string" }, "create_time": { "format": "date-time", "type": "string" }, "expire_time": { "format": "date-time", "type": "string" }, "ip_restriction": { "$ref": "#/components/schemas/IPRestriction" }, "key_id": { "type": "string" }, "last_used_time": { "format": "date-time", "type": "string" }, "metadata": { "description": "metadata is a free-form JSON object for caller-defined attributes\n(e.g., source, environment, tags). Values may be strings, numbers,\nbooleans, arrays, objects, or null. Total serialized size is capped\nat 4KB. AIP-148 metadata field.", "type": "object" }, "name": { "type": "string" }, "rate_limit_policy": { "$ref": "#/components/schemas/RateLimitPolicy" }, "revocation_description": { "description": "revocation_description provides free-form context for a revocation.\nOnly set when revocation_reason is PRIVILEGE_WITHDRAWN.\nJSON API change: field was formerly revocation_reason_text. Field number 13\nis unchanged so the change is wire-compatible for binary proto encoding.", "type": "string" }, "revocation_reason": { "$ref": "#/components/schemas/RevocationReason" }, "scopes": { "items": { "type": "string" }, "type": "array" }, "status": { "$ref": "#/components/schemas/KeyStatus" }, "update_time": { "format": "date-time", "type": "string" }, "visibility": { "$ref": "#/components/schemas/KeyVisibility" } }, "type": "object" }, "JSONRawMessage": { "title": "JSONRawMessage represents a json.RawMessage that works well with JSON, SQL, and Swagger.", "type": "object" }, "KetoNamespace": { "properties": { "id": { "format": "int64", "type": "integer" }, "name": { "type": "string" } }, "type": "object" }, "KetoNamespaces": { "items": { "$ref": "#/components/schemas/KetoNamespace" }, "type": "array" }, "KeyState": { "description": "Only a \"confirmed\" key can be used to authenticate. A \"locked\" key was\ndisabled after too many wrong-PIN attempts; rotating its pin_secret unlocks\nit.", "enum": [ "initial", "confirmed", "locked" ], "title": "KeyState is the lifecycle state of an enrolled key.", "type": "string" }, "KeyStatus": { "default": "KEY_STATUS_UNSPECIFIED", "description": "KeyStatus represents the lifecycle state of an API key.\n\n - KEY_STATUS_UNSPECIFIED: Default zero value. Never returned by the server. Treated as ACTIVE for\nbackward compatibility but should not be relied on.\n - KEY_STATUS_ACTIVE: The key is valid and can be used to authenticate.\n - KEY_STATUS_REVOKED: The key was revoked and can no longer authenticate. On the API key object,\nthe revocation_reason field carries the cause (set via the admin and\nself-revocation flows). Verification responses do not include this status:\na revoked key fails verification with error_code VERIFICATION_ERROR_REVOKED.\n - KEY_STATUS_EXPIRED: The key passed its expire_time. Verification fails with\nVERIFICATION_ERROR_EXPIRED. The transition is computed at read time and\nnot persisted.", "enum": [ "KEY_STATUS_UNSPECIFIED", "KEY_STATUS_ACTIVE", "KEY_STATUS_REVOKED", "KEY_STATUS_EXPIRED" ], "type": "string" }, "KeyVisibility": { "default": "KEY_VISIBILITY_UNSPECIFIED", "description": "KeyVisibility distinguishes public (client-safe) keys from secret (server-only) keys.\nPublic keys use a different configurable prefix for visual distinction.\nBoth types share the same scope/permission system — visibility is about exposure safety.\n\n - KEY_VISIBILITY_UNSPECIFIED: Treated as SECRET", "enum": [ "KEY_VISIBILITY_UNSPECIFIED", "KEY_VISIBILITY_SECRET", "KEY_VISIBILITY_PUBLIC" ], "type": "string" }, "LineItemV1": { "properties": { "amount_in_cent": { "$ref": "#/components/schemas/AmountInCent" }, "description": { "type": "string" }, "items": { "description": "Each line item can have sub-items to create a hierarchy.", "items": { "$ref": "#/components/schemas/LineItemV1" }, "type": "array" }, "quantity": { "format": "int64", "type": "integer" }, "title": { "type": "string" }, "unit_price": { "type": "string" } }, "type": "object" }, "ListImportedApiKeysResponse": { "properties": { "imported_api_keys": { "items": { "$ref": "#/components/schemas/ImportedApiKey" }, "title": "List of imported keys", "type": "array" }, "next_page_token": { "title": "Token for fetching the next page (empty if no more results)", "type": "string" } }, "title": "ListImportedApiKeysResponse returns paginated list of imported keys", "type": "object" }, "ListIssuedApiKeysResponse": { "properties": { "issued_api_keys": { "items": { "$ref": "#/components/schemas/IssuedApiKey" }, "type": "array" }, "next_page_token": { "type": "string" } }, "type": "object" }, "Money": { "type": "string" }, "NormalizedProjectRevisionCourierChannel": { "properties": { "channel_id": { "description": "The Channel's public ID", "type": "string" }, "created_at": { "description": "The creation date", "format": "date-time", "readOnly": true, "type": "string" }, "request_config_auth_config_api_key_in": { "description": "API key location\n\nCan either be \"header\" or \"query\"", "example": "header", "type": "string" }, "request_config_auth_config_api_key_name": { "description": "API key name\n\nOnly used if the auth type is api_key", "type": "string" }, "request_config_auth_config_api_key_value": { "description": "API key value\n\nOnly used if the auth type is api_key", "type": "string" }, "request_config_auth_config_basic_auth_password": { "description": "Basic Auth Password\n\nOnly used if the auth type is basic_auth", "type": "string" }, "request_config_auth_config_basic_auth_user": { "description": "Basic Auth Username\n\nOnly used if the auth type is basic_auth", "type": "string" }, "request_config_auth_type": { "description": "HTTP Auth Method to use for the HTTP call\n\nCan either be basic_auth or api_key\nbasic_auth CourierChannelAuthTypeBasicAuth\napi_key CourierChannelAuthTypeApiKey", "enum": [ "basic_auth", "api_key" ], "type": "string", "x-go-enum-desc": "basic_auth CourierChannelAuthTypeBasicAuth\napi_key CourierChannelAuthTypeApiKey" }, "request_config_body": { "description": "URI pointing to the JsonNet template used for HTTP body payload generation.", "type": "string" }, "request_config_headers": { "$ref": "#/components/schemas/nullJsonRawMessage" }, "request_config_method": { "description": "The HTTP method to use (GET, POST, etc) for the HTTP call", "example": "POST", "type": "string" }, "request_config_url": { "type": "string" }, "updated_at": { "description": "Last upate time", "format": "date-time", "readOnly": true, "type": "string" } }, "required": [ "channel_id", "request_config_method", "request_config_body" ], "type": "object" }, "NullBool": { "nullable": true, "type": "boolean" }, "NullDuration": { "nullable": true, "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "NullInt": { "nullable": true, "type": "integer" }, "NullString": { "nullable": true, "type": "string" }, "NullTime": { "format": "date-time", "nullable": true, "type": "string" }, "NullUUID": { "format": "uuid4", "nullable": true, "type": "string" }, "NullValue": { "default": "NULL_VALUE", "description": "`NullValue` is a singleton enumeration to represent the null value for the\n`Value` type union.\n\nThe JSON representation for `NullValue` is JSON `null`.\n\n - NULL_VALUE: Null value.", "enum": [ "NULL_VALUE" ], "type": "string" }, "OAuth2LoginChallengeParams": { "type": "object" }, "OrganizationBody": { "description": "Create B2B SSO Organization Request Body", "properties": { "default_region": { "description": "DefaultRegion is the default Ory region for identities provisioned\ninto this organization via JIT. Must be inside the project's home\nregion.\n\nEmpty (or omitted) means the organization has no default region:\neach identity provisioned via JIT is then homed in the gateway\nregion of the request that created it, constrained by the project's\nhome region. On update, an empty string clears the value.\neu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global", "enum": [ "eu-central", "asia-northeast", "us-east", "us-west", "eu", "asia", "us", "global" ], "type": "string", "x-go-enum-desc": "eu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global" }, "domains": { "description": "Domains contains the list of organization's domains.", "items": { "type": "string" }, "type": "array" }, "label": { "description": "Label contains the organization's label.", "type": "string" }, "session_lifespan": { "description": "SessionLifespan overrides the project-level session.lifespan for sessions\nissued for this organization. A Go duration string between 1m and 8760h\n(e.g. \"1h\", \"24h\"). Send \"\" to clear and inherit the project default. Omit\nto leave the existing value unchanged on update.", "example": "24h", "type": "string" } }, "type": "object" }, "PINConfig": { "description": "The pin_secret field holds only the at-rest ciphertext; the plaintext\nexists transiently in server memory during verification and is invalidated\nonce the key locks.", "properties": { "created_at": { "description": "When the pin_secret was first issued.", "format": "date-time", "type": "string" }, "failed_attempts": { "description": "The number of consecutive wrong-PIN attempts so far; the key locks when\nit reaches the configured maximum (pin_max_attempts, default 5).", "format": "uint64", "type": "integer" }, "pin_secret": { "description": "The at-rest ciphertext of the pin_secret. It never leaves the server and\nis cleared once the key locks.", "type": "string", "writeOnly": true }, "rotated_at": { "description": "When the pin_secret was last rotated. Omitted if the secret was never\nrotated.", "format": "date-time", "type": "string" } }, "title": "PINConfig is the per-key PIN state.", "type": "object" }, "ParseError": { "properties": { "end": { "$ref": "#/components/schemas/SourcePosition" }, "message": { "type": "string" }, "start": { "$ref": "#/components/schemas/SourcePosition" } }, "type": "object" }, "PatchWorkspaceMemberBody": { "properties": { "break_glass": { "description": "Whether to enable break-glass recovery for this member.", "type": "boolean" } }, "type": "object" }, "Plan": { "properties": { "name": { "description": "Name is the name of the plan.", "type": "string" }, "version": { "description": "Version is the version of the plan. The combination of `name@version` must be unique.", "format": "int64", "type": "integer" } }, "required": [ "name", "version" ], "type": "object" }, "PlanDetails": { "properties": { "base_fee_monthly": { "description": "BaseFeeMonthly is the monthly base fee for the plan.", "format": "int64", "type": "integer" }, "base_fee_yearly": { "description": "BaseFeeYearly is the yearly base fee for the plan.", "format": "int64", "type": "integer" }, "custom": { "description": "Custom is true if the plan is custom. This means it will be hidden from the pricing page.", "type": "boolean" }, "description": { "description": "Description is the description of the plan.", "type": "string" }, "development_features": { "$ref": "#/components/schemas/PlanFeatures" }, "features": { "$ref": "#/components/schemas/PlanFeatures" }, "latest": { "description": "Latest is true if the plan is the latest version of a plan and should be available for self-service usage.", "type": "boolean" }, "name": { "description": "Name is the name of the plan.", "type": "string" }, "production_features": { "$ref": "#/components/schemas/PlanFeatures" }, "staging_features": { "$ref": "#/components/schemas/PlanFeatures" }, "version": { "description": "Version is the version of the plan. The combination of `name@version` must be unique.", "format": "int64", "type": "integer" }, "yearly_only": { "description": "YearlyOnly is true if the plan only supports yearly billing.", "type": "boolean" } }, "required": [ "name", "version", "description", "custom", "yearly_only", "base_fee_monthly", "base_fee_yearly", "features", "production_features", "staging_features", "development_features" ], "type": "object" }, "PlanFeatures": { "additionalProperties": { "$ref": "#/components/schemas/Usage" }, "title": "PlanFeatures are the feature definitions included in the plan.", "type": "object" }, "Pricing": { "items": { "$ref": "#/components/schemas/PlanDetails" }, "type": "array" }, "ProjectEventsDatapoint": { "properties": { "attributes": { "description": "Event attributes with details", "items": { "$ref": "#/components/schemas/Attribute" }, "type": "array" }, "name": { "description": "Name of the event", "type": "string" }, "timestamp": { "description": "Time of occurence", "format": "date-time", "type": "string" } }, "required": [ "name", "timestamp", "attributes" ], "type": "object" }, "Provider": { "properties": { "client_id": { "description": "The RP's client identifier, issued by the IdP.", "type": "string" }, "config_url": { "description": "A full path of the IdP config file.", "type": "string" }, "domain_hint": { "description": "By specifying one of domain_hints values provided by the accounts endpoints,\nthe FedCM dialog selectively shows the specified account.", "type": "string" }, "fields": { "description": "Array of strings that specifies the user information (\"name\", \" email\",\n\"picture\") that RP needs IdP to share with them.\n\nNote: Field API is supported by Chrome 132 and later.", "items": { "type": "string" }, "type": "array" }, "login_hint": { "description": "By specifying one of login_hints values provided by the accounts endpoints,\nthe FedCM dialog selectively shows the specified account.", "type": "string" }, "nonce": { "description": "A random string to ensure the response is issued for this specific request.\nPrevents replay attacks.", "type": "string" }, "parameters": { "additionalProperties": { "type": "string" }, "description": "Custom object that allows to specify additional key-value parameters:\nscope: A string value containing additional permissions that RP needs to\nrequest, for example \" drive.readonly calendar.readonly\"\nnonce: A random string to ensure the response is issued for this specific\nrequest. Prevents replay attacks.\n\nOther custom key-value parameters.\n\nNote: parameters is supported from Chrome 132.", "type": "object" } }, "type": "object" }, "RFC6749ErrorJson": { "properties": { "error": { "type": "string" }, "error_debug": { "type": "string" }, "error_description": { "type": "string" }, "error_hint": { "type": "string" }, "status_code": { "format": "int64", "type": "integer" } }, "title": "RFC6749ErrorJson is a helper struct for JSON encoding/decoding of RFC6749Error.", "type": "object" }, "RateLimitPolicy": { "description": "RateLimitPolicy describes the rate limit policy for an API key.\n\nIn OSS mode, this policy is informational and meant to be consumed by\nupstream gateways (Envoy, Cloudflare, etc.) for enforcement.\nIn commercial mode, Talos enforces rate limits using in-memory or Redis backends,\nboth powered by the GCRA (Generic Cell Rate Algorithm).\n\nCompliant with draft-ietf-httpapi-ratelimit-headers-10.", "properties": { "quota": { "description": "quota is the number of requests allowed per window.", "format": "int64", "type": "string" }, "unit": { "title": "unit describes the quota unit type.\nDefault: \"requests\"\nOther valid values per IETF spec: \"content-bytes\", \"concurrent-requests\"", "type": "string" }, "window": { "description": "window is the time window for the quota.\nCommon values: 60s (1 minute), 3600s (1 hour), 86400s (1 day).", "type": "string" } }, "type": "object" }, "RevisionAccountExperienceCustomTranslation": { "properties": { "locale": { "description": "The locale (e.g. \"en\", \"de\")", "type": "string" }, "translations": { "description": "The URL where the i18n json can be found", "type": "string" } }, "required": [ "locale", "translations" ], "type": "object" }, "RevocationReason": { "default": "REVOCATION_REASON_UNSPECIFIED", "description": "RevocationReason provides structured revocation reasons inspired by RFC 5280.\nUsed in both admin and self-revocation flows.\n\n - REVOCATION_REASON_UNSPECIFIED: Default zero value. Use a specific reason; UNSPECIFIED is rejected by\nadmin and self-revocation endpoints.\n - REVOCATION_REASON_KEY_COMPROMISE: The key was leaked or believed to be in the hands of an unauthorized\nparty.\n - REVOCATION_REASON_AFFILIATION_CHANGED: The owning actor's relationship with the issuer changed (e.g., role\nchange, departure).\n - REVOCATION_REASON_SUPERSEDED: A new key has replaced this one as part of a rotation.\n - REVOCATION_REASON_PRIVILEGE_WITHDRAWN: Admin-only. The actor's privilege to use this key was withdrawn by\nan operator. Self-revocation requests using this reason are rejected\nwith InvalidArgument. Pair with `description` on the admin revoke requests\nto record the operator-supplied justification.", "enum": [ "REVOCATION_REASON_UNSPECIFIED", "REVOCATION_REASON_KEY_COMPROMISE", "REVOCATION_REASON_AFFILIATION_CHANGED", "REVOCATION_REASON_SUPERSEDED", "REVOCATION_REASON_PRIVILEGE_WITHDRAWN" ], "type": "string" }, "RotateIssuedApiKeyResponse": { "properties": { "issued_api_key": { "$ref": "#/components/schemas/IssuedApiKey" }, "old_issued_api_key": { "$ref": "#/components/schemas/IssuedApiKey" }, "secret": { "title": "secret is the new API key secret (only returned once, never retrievable again)", "type": "string" } }, "type": "object" }, "SelfRevokeApiKeyRequest": { "description": "SelfRevokeApiKeyRequest allows an API key holder to revoke their own key\nby providing the full key secret as proof of possession.", "properties": { "credential": { "title": "Full API key secret or imported key (REQUIRED)", "type": "string" }, "reason": { "$ref": "#/components/schemas/RevocationReason" } }, "type": "object" }, "SelfRevokeApiKeyResponse": { "description": "SelfRevokeApiKeyResponse is returned on successful self-revocation.\n\nEmpty on success", "type": "object" }, "SessionActivityDatapoint": { "properties": { "country": { "description": "Country of the events", "type": "string" }, "failed": { "description": "Number of events that failed in the given timeframe", "format": "int64", "type": "integer" }, "succeeded": { "description": "Number of events that succeeded in the given timeframe", "format": "int64", "type": "integer" } }, "required": [ "succeeded", "failed", "country" ], "type": "object" }, "SourcePosition": { "properties": { "Line": { "format": "int64", "type": "integer" }, "column": { "format": "int64", "type": "integer" } }, "type": "object" }, "Status": { "properties": { "code": { "format": "int32", "type": "integer" }, "details": { "items": { "$ref": "#/components/schemas/Any" }, "type": "array" }, "message": { "type": "string" } }, "type": "object" }, "String": { "$ref": "#/components/schemas/NullString" }, "SubscriptionStatus": { "description": "For `collection_method=charge_automatically` a subscription moves into `incomplete` if the initial payment attempt fails. A subscription in this status can only have metadata and default_source updated. Once the first invoice is paid, the subscription moves into an `active` status. If the first invoice is not paid within 23 hours, the subscription transitions to `incomplete_expired`. This is a terminal status, the open invoice will be voided and no further invoices will be generated.\n\nA subscription that is currently in a trial period is `trialing` and moves to `active` when the trial period is over.\n\nA subscription can only enter a `paused` status [when a trial ends without a payment method](https://stripe.com/billing/subscriptions/trials#create-free-trials-without-payment). A `paused` subscription doesn't generate invoices and can be resumed after your customer adds their payment method. The `paused` status is different from [pausing collection](https://stripe.com/billing/subscriptions/pause-payment), which still generates invoices and leaves the subscription's status unchanged.\n\nIf subscription `collection_method=charge_automatically`, it becomes `past_due` when payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will become `canceled` or `unpaid` (depending on your subscriptions settings).\n\nIf subscription `collection_method=send_invoice` it becomes `past_due` when its invoice is not paid by the due date, and `canceled` or `unpaid` if it is still not paid by an additional deadline after that. Note that when a subscription has a status of `unpaid`, no subsequent invoices will be attempted (invoices will be created, but then immediately automatically closed). After receiving updated payment information from a customer, you may choose to reopen and pay their closed invoices.", "title": "Possible values are `incomplete`, `incomplete_expired`, `trialing`, `active`, `past_due`, `canceled`, `unpaid`, or `paused`.", "type": "string" }, "TaxLineItem": { "properties": { "amount_in_cent": { "$ref": "#/components/schemas/AmountInCent" }, "title": { "type": "string" } }, "type": "object" }, "Time": { "format": "date-time", "type": "string" }, "TimeInterval": { "properties": { "end": { "description": "The end of the time period.", "format": "date-time", "type": "string" }, "start": { "description": "The start of the time period.", "format": "date-time", "type": "string" } }, "required": [ "start", "end" ], "type": "object" }, "Token": { "properties": { "claims": { "description": "claims is the decoded token payload. For JWT, this contains the\nstandard claims (iss, sub, aud, exp, iat, jti) plus custom claims.\nFor macaroons, this lists the caveats. The shape is backend-dependent\nand should be treated as opaque diagnostic data.", "type": "object" }, "expire_time": { "format": "date-time", "type": "string" }, "scopes": { "items": { "type": "string" }, "type": "array" }, "token": { "description": "The encoded token string. JWT tokens are signed JWS in compact\nserialization (header.payload.signature). Macaroons are base64-encoded\nbinary blobs.", "type": "string" } }, "title": "Token represents a short-lived derived token (JWT or Macaroon)", "type": "object" }, "TokenAlgorithm": { "default": "TOKEN_ALGORITHM_UNSPECIFIED", "description": "- TOKEN_ALGORITHM_JWT: JWT with EdDSA (self-contained, signed)\n - TOKEN_ALGORITHM_MACAROON: Macaroon with HMAC (self-contained, caveat-based)", "enum": [ "TOKEN_ALGORITHM_UNSPECIFIED", "TOKEN_ALGORITHM_JWT", "TOKEN_ALGORITHM_MACAROON" ], "title": "TokenAlgorithm specifies the cryptographic algorithm used for derived tokens\nNote: API keys (root tokens) are always opaque; this enum is only for DeriveToken", "type": "string" }, "UUID": { "format": "uuid4", "type": "string" }, "UpdateFedcmFlowBody": { "properties": { "csrf_token": { "description": "CSRFToken is the anti-CSRF token.", "type": "string" }, "nonce": { "description": "Nonce is the nonce that was used in the `navigator.credentials.get` call. If\nspecified, it must match the `nonce` claim in the token.", "type": "string" }, "token": { "description": "Token contains the result of `navigator.credentials.get`.", "type": "string" }, "transient_payload": { "description": "Transient data to pass along to any webhooks.", "type": "object" } }, "required": [ "token", "csrf_token" ], "type": "object" }, "Usage": { "oneOf": [ { "$ref": "#/components/schemas/GenericUsage" }, { "type": "string" }, { "type": "boolean" }, { "type": "number" } ] }, "UserVerification": { "description": "\"pin\" means the holder proves knowledge of a PIN via pin_proof at login;\n\"platform\" means the device gates key use behind platform biometrics or an\nequivalent lock screen; \"none\" marks a possession-only key, usable as a\nsecond factor but never as the sole first factor. The empty value marks a\nlegacy key from before user verification existed; such keys are rejected at\nlogin and must be re-enrolled.", "enum": [ "pin", "platform", "none" ], "title": "UserVerification records how the key's holder is verified at use time.", "type": "string" }, "VerifiableCredentialProof": { "properties": { "jwt": { "type": "string" }, "proof_type": { "type": "string" } }, "title": "VerifiableCredentialProof contains the proof of a verifiable credential.", "type": "object" }, "VerificationErrorCode": { "default": "VERIFICATION_ERROR_UNSPECIFIED", "description": "- VERIFICATION_ERROR_UNSPECIFIED: No error (key is valid)\n - VERIFICATION_ERROR_INVALID_FORMAT: Credential format is invalid\n - VERIFICATION_ERROR_EXPIRED: Credential has expired\n - VERIFICATION_ERROR_REVOKED: Credential has been revoked\n - VERIFICATION_ERROR_NOT_FOUND: Credential not found in database\n - VERIFICATION_ERROR_SIGNATURE_INVALID: Cryptographic signature verification failed\n - VERIFICATION_ERROR_INTERNAL: Internal server error during verification\n - VERIFICATION_ERROR_IP_NOT_ALLOWED: Request IP is not in the key's allowed CIDR ranges\n - VERIFICATION_ERROR_RATE_LIMITED: Rate limit quota exhausted (commercial-only)", "enum": [ "VERIFICATION_ERROR_UNSPECIFIED", "VERIFICATION_ERROR_INVALID_FORMAT", "VERIFICATION_ERROR_EXPIRED", "VERIFICATION_ERROR_REVOKED", "VERIFICATION_ERROR_NOT_FOUND", "VERIFICATION_ERROR_SIGNATURE_INVALID", "VERIFICATION_ERROR_INTERNAL", "VERIFICATION_ERROR_IP_NOT_ALLOWED", "VERIFICATION_ERROR_RATE_LIMITED" ], "title": "VerificationErrorCode provides type-safe error codes for verification failures", "type": "string" }, "VerifyApiKeyRequest": { "properties": { "credential": { "title": "API key or derived token (any format: sk_*, JWT, macaroon)", "type": "string" } }, "type": "object" }, "VerifyApiKeyResponse": { "properties": { "actor_id": { "type": "string" }, "error_code": { "$ref": "#/components/schemas/VerificationErrorCode" }, "error_message": { "title": "Human-readable error message (only set if is_valid=false)", "type": "string" }, "expire_time": { "format": "date-time", "type": "string" }, "is_valid": { "description": "is_valid reports whether verification succeeded. It is true only when the\ncredential parses, the signature checks out, the key was found, all\npolicy gates (expiry, revocation, IP allowlist, rate limit) pass, and the\nkey's status is KEY_STATUS_ACTIVE. When false, error_code and\nerror_message describe the reason. Use this field for authentication\ndecisions; use status to inspect lifecycle state independently.", "type": "boolean" }, "issuer": { "description": "The configured token issuer for this project. For derived tokens (JWT/macaroon),\nthis matches the iss claim embedded in the verified token.", "type": "string" }, "key_id": { "type": "string" }, "metadata": { "description": "metadata mirrors the metadata stored on the verified key. AIP-148\nmetadata field.", "type": "object" }, "rate_limit_policy": { "$ref": "#/components/schemas/RateLimitPolicy" }, "rate_limit_remaining": { "description": "Approximate number of requests available before the rate limit is reached\n(commercial-only, only set when enforcement is active).", "format": "int64", "type": "string" }, "rate_limit_reset_time": { "description": "Time when the rate limiter returns to full capacity (all quota recovered).", "format": "date-time", "type": "string" }, "scopes": { "items": { "type": "string" }, "type": "array" }, "status": { "$ref": "#/components/schemas/KeyStatus" }, "visibility": { "$ref": "#/components/schemas/KeyVisibility" } }, "type": "object" }, "Warning": { "properties": { "code": { "format": "int64", "type": "integer" }, "message": { "type": "string" } }, "type": "object" }, "acceptDeviceUserCodeRequest": { "description": "Contains information on an device verification", "properties": { "user_code": { "type": "string" } }, "type": "object" }, "acceptOAuth2ConsentRequest": { "properties": { "context": { "$ref": "#/components/schemas/JSONRawMessage" }, "grant_access_token_audience": { "description": "GrantedAudience sets the audience the user authorized the client to use. Should be a subset of `requested_access_token_audience`.", "items": { "type": "string" }, "type": "array" }, "grant_scope": { "description": "GrantScope sets the scope the user authorized the client to use. Should be a subset of `requested_scope`.", "items": { "type": "string" }, "type": "array" }, "remember": { "description": "Remember, if set to true, tells ORY Hydra to remember this consent authorization and reuse it if the same\nclient asks the same user for the same, or a subset of, scope.", "type": "boolean" }, "remember_for": { "description": "RememberFor sets how long the consent authorization should be remembered for in seconds. If set to `0`, the\nauthorization will be remembered indefinitely.", "format": "int64", "type": "integer" }, "session": { "$ref": "#/components/schemas/acceptOAuth2ConsentRequestSession" } }, "title": "The request payload used to accept a consent request.", "type": "object" }, "acceptOAuth2ConsentRequestSession": { "properties": { "access_token": { "description": "AccessToken sets session data for the access and refresh token, as well as any future tokens issued by the\nrefresh grant. Keep in mind that this data will be available to anyone performing OAuth 2.0 Challenge Introspection.\nIf only your services can perform OAuth 2.0 Challenge Introspection, this is usually fine. But if third parties\ncan access that endpoint as well, sensitive data from the session might be exposed to them. Use with care!" }, "id_token": { "description": "IDToken sets session data for the OpenID Connect ID token. Keep in mind that the session'id payloads are readable\nby anyone that has access to the ID Challenge. Use with care!" } }, "title": "Pass session data to a consent request.", "type": "object" }, "acceptOAuth2LoginRequest": { "properties": { "acr": { "description": "ACR sets the Authentication AuthorizationContext Class Reference value for this authentication session. You can use it\nto express that, for example, a user authenticated using two-factor authentication.", "type": "string" }, "amr": { "description": "AMR sets the Authentication Methods References value for this\nauthentication session. You can use it to specify the method a user used to\nauthenticate. For example, if the acr indicates a user used two-factor\nauthentication, the amr can express they used a software-secured key.", "items": { "type": "string" }, "type": "array" }, "context": { "$ref": "#/components/schemas/JSONRawMessage" }, "extend_session_lifespan": { "description": "Extend OAuth2 authentication session lifespan\n\nIf set to `true`, the OAuth2 authentication cookie lifespan is extended. This is for example useful if you want the user to be able to use `prompt=none` continuously.\n\nThis value can only be set to `true` if the user has an authentication, which is the case if the `skip` value is `true`.", "type": "boolean" }, "force_subject_identifier": { "description": "ForceSubjectIdentifier forces the \"pairwise\" user ID of the end-user that authenticated. The \"pairwise\" user ID refers to the\n(Pairwise Identifier Algorithm)[http://openid.net/specs/openid-connect-core-1_0.html#PairwiseAlg] of the OpenID\nConnect specification. It allows you to set an obfuscated subject (\"user\") identifier that is unique to the client.\n\nPlease note that this changes the user ID on endpoint /userinfo and sub claim of the ID Token. It does not change the\nsub claim in the OAuth 2.0 Introspection.\n\nPer default, ORY Hydra handles this value with its own algorithm. In case you want to set this yourself\nyou can use this field. Please note that setting this field has no effect if `pairwise` is not configured in\nORY Hydra or the OAuth 2.0 Client does not expect a pairwise identifier (set via `subject_type` key in the client's\nconfiguration).\n\nPlease also be aware that ORY Hydra is unable to properly compute this value during authentication. This implies\nthat you have to compute this value on every authentication process (probably depending on the client ID or some\nother unique value).\n\nIf you fail to compute the proper value, then authentication processes which have id_token_hint set might fail.", "type": "string" }, "identity_provider_session_id": { "description": "IdentityProviderSessionID is the session ID of the end-user that authenticated.\nIf specified, we will use this value to propagate the logout.", "type": "string" }, "remember": { "description": "Remember, if set to true, tells Ory Hydra to remember this user by telling the user agent (browser) to store\na cookie with authentication data. If the same user performs another OAuth 2.0 Authorization Request, they\nwill not be asked to log in again.", "type": "boolean" }, "remember_for": { "description": "RememberFor sets how long the authentication should be remembered for in seconds. If set to `0`, the\nauthorization will be remembered for the duration of the browser session (using a session cookie).", "format": "int64", "type": "integer" }, "subject": { "description": "Subject is the user ID of the end-user that authenticated.", "type": "string" } }, "required": [ "subject" ], "title": "HandledLoginRequest is the request payload used to accept a login request.", "type": "object" }, "accountExperienceConfiguration": { "properties": { "contact_url": { "description": "The URL to the project's Contact page.", "type": "string" }, "default_locale": { "type": "string" }, "default_redirect_url": { "type": "string" }, "enabled_locales": { "items": { "type": "string" }, "type": "array" }, "error_ui_url": { "type": "string" }, "favicon_dark_url": { "type": "string" }, "favicon_light_url": { "type": "string" }, "hide_ory_branding": { "type": "boolean" }, "hide_registration_link": { "type": "boolean" }, "locale_behavior": { "description": "\nforce_default AccountExperienceLocaleBehaviorForceDefault\nrespect_accept_language AccountExperienceLocaleBehaviorRespectAcceptLanguage", "enum": [ "force_default", "respect_accept_language" ], "type": "string", "x-go-enum-desc": "force_default AccountExperienceLocaleBehaviorForceDefault\nrespect_accept_language AccountExperienceLocaleBehaviorRespectAcceptLanguage" }, "login_ui_url": { "type": "string" }, "logo_dark_url": { "type": "string" }, "logo_light_url": { "type": "string" }, "name": { "type": "string" }, "privacy_policy_url": { "description": "The URL to the project's Privacy Policy page.", "type": "string" }, "recovery_enabled": { "type": "boolean" }, "recovery_ui_url": { "type": "string" }, "registration_enabled": { "type": "boolean" }, "registration_ui_url": { "type": "string" }, "settings_ui_url": { "type": "string" }, "stylesheet": { "type": "string" }, "terms_of_service_url": { "description": "The URL to the project's Terms of Service page.", "type": "string" }, "translations": { "items": { "$ref": "#/components/schemas/RevisionAccountExperienceCustomTranslation" }, "type": "array" }, "verification_enabled": { "type": "boolean" }, "verification_ui_url": { "type": "string" } }, "required": [ "name", "locale_behavior", "default_locale", "registration_enabled", "hide_registration_link", "verification_enabled", "recovery_enabled", "recovery_ui_url", "registration_ui_url", "verification_ui_url", "login_ui_url", "settings_ui_url", "error_ui_url", "default_redirect_url", "translations", "enabled_locales", "hide_ory_branding" ], "type": "object" }, "addProjectToWorkspaceBody": { "properties": { "environment": { "description": "The environment of the project in the workspace. Can be one of \"prod\" or\n\"dev\". Note that the number of projects in the \"prod\" environment is limited\ndepending on the subscription.\nprod Production\nstage Staging\ndev Development", "enum": [ "prod", "stage", "dev" ], "type": "string", "x-go-enum-desc": "prod Production\nstage Staging\ndev Development" }, "project_subscription": { "description": "The action to take with the project subscription. Can be one of \"migrate\", and\n\"ignore\". \"migrate\" will migrate the project subscription to the workspace.\n\"ignore\" will ignore the project subscription.\nmigrate ProjectSubscriptionActionMigrate ProjectSubscriptionActionMigrate will migrate the project subscription to the workspace.\nignore ProjectSubscriptionActionIgnore ProjectSubscriptionActionIgnore will ignore the project subscription.", "enum": [ "migrate", "ignore" ], "type": "string", "x-go-enum-desc": "migrate ProjectSubscriptionActionMigrate ProjectSubscriptionActionMigrate will migrate the project subscription to the workspace.\nignore ProjectSubscriptionActionIgnore ProjectSubscriptionActionIgnore will ignore the project subscription." } }, "required": [ "project_subscription", "environment" ], "title": "AddProjectToWorkspaceBody contains the options for migrating a project to a workspace.", "type": "object" }, "authenticatorAssuranceLevel": { "description": "The authenticator assurance level can be one of \"aal1\", \"aal2\", or \"aal3\". A higher number means that it is harder\nfor an attacker to compromise the account.\n\nGenerally, \"aal1\" implies that one authentication factor was used while AAL2 implies that two factors (e.g.\npassword + TOTP) have been used.\n\nTo learn more about these levels please head over to: https://www.ory.com/kratos/docs/concepts/credentials", "enum": [ "aal0", "aal1", "aal2", "aal3" ], "title": "Authenticator Assurance Level (AAL)", "type": "string" }, "basicOrganization": { "properties": { "default_region": { "description": "DefaultRegion sets the default region for identities provisioned into\nthis organization, when the identity does not specify a region explictly.\neu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global", "enum": [ "eu-central", "asia-northeast", "us-east", "us-west", "eu", "asia", "us", "global" ], "type": "string", "x-go-enum-desc": "eu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global" }, "domains": { "description": "The list of organization's domains.", "items": { "type": "string" }, "type": "array" }, "id": { "description": "The organization's ID.", "format": "uuid", "type": "string" }, "label": { "description": "The organization's human-readable label.", "type": "string" }, "session_lifespan": { "description": "SessionLifespan overrides the project-level session lifespan for sessions\nissued for this organization. A Go duration string between 1m and 8760h.\nA null (or zero) value means the project default applies.", "example": "24h", "pattern": "^[0-9]+(s|m|h)$", "type": "string" } }, "required": [ "id", "label", "domains" ], "type": "object" }, "batchCheckPermissionBody": { "description": "Batch Check Permission Body", "properties": { "tuples": { "items": { "$ref": "#/components/schemas/relationship" }, "type": "array" } }, "type": "object" }, "batchCheckPermissionResult": { "description": "Batch Check Permission Result", "properties": { "results": { "description": "An array of check results. The order aligns with the input order.", "items": { "$ref": "#/components/schemas/checkPermissionResultWithError" }, "type": "array" } }, "required": [ "results" ], "type": "object" }, "batchPatchIdentitiesResponse": { "description": "Patch identities response", "properties": { "identities": { "description": "The patch responses for the individual identities.", "items": { "$ref": "#/components/schemas/identityPatchResponse" }, "type": "array" } }, "type": "object" }, "checkOplSyntaxBody": { "description": "Ory Permission Language Document", "type": "string" }, "checkOplSyntaxResult": { "properties": { "errors": { "description": "The list of syntax errors", "items": { "$ref": "#/components/schemas/ParseError" }, "type": "array" } }, "title": "CheckOPLSyntaxResponse represents the response for an OPL syntax check request.", "type": "object" }, "checkPermissionResult": { "description": "The content of the allowed field is mirrored in the HTTP status code.", "properties": { "allowed": { "description": "whether the relation tuple is allowed", "type": "boolean" } }, "required": [ "allowed" ], "title": "Check Permission Result", "type": "object" }, "checkPermissionResultWithError": { "description": "Check Permission Result With Error", "properties": { "allowed": { "description": "whether the relation tuple is allowed", "type": "boolean" }, "error": { "description": "any error generated while checking the relation tuple", "type": "string" } }, "required": [ "allowed" ], "type": "object" }, "cloudAccount": { "properties": { "break_glass": { "description": "BreakGlass is true when the identity's recovery address has break-glass\nrecovery enabled for the identity's current organization.", "type": "boolean" }, "email": { "type": "string" }, "email_verified": { "type": "boolean" }, "id": { "format": "uuid", "type": "string" }, "name": { "type": "string" }, "organization_id": { "$ref": "#/components/schemas/NullUUID" } }, "required": [ "id", "email", "name", "email_verified" ], "type": "object" }, "continueWith": { "discriminator": { "mapping": { "redirect_browser_to": "#/components/schemas/continueWithRedirectBrowserTo", "set_ory_session_token": "#/components/schemas/continueWithSetOrySessionToken", "show_pin_entry_ui": "#/components/schemas/continueWithDeviceAuthnPinEntryUi", "show_recovery_ui": "#/components/schemas/continueWithRecoveryUi", "show_settings_ui": "#/components/schemas/continueWithSettingsUi", "show_verification_ui": "#/components/schemas/continueWithVerificationUi" }, "propertyName": "action" }, "oneOf": [ { "$ref": "#/components/schemas/continueWithVerificationUi" }, { "$ref": "#/components/schemas/continueWithSetOrySessionToken" }, { "$ref": "#/components/schemas/continueWithSettingsUi" }, { "$ref": "#/components/schemas/continueWithRecoveryUi" }, { "$ref": "#/components/schemas/continueWithRedirectBrowserTo" }, { "$ref": "#/components/schemas/continueWithDeviceAuthnPinEntryUi" } ], "type": "object" }, "continueWithDeviceAuthnPinEntryUi": { "description": "Returned after a PIN-protected DeviceAuthn enrollment or secret rotation.\nIt carries the one-time HPKE-sealed pin_secret, which the device opens with\nthe transport private key it generated for this enrollment and binds to the\nuser's PIN. The plaintext secret never leaves the device; the server only\never stores its at-rest ciphertext.\n\nThe enrolled key's client_key_id is not included: it is the SHA-256 fingerprint\nof the device's own public key, which the device derives locally. Non-PIN keys\nneed no client action at all and therefore produce no continue_with.", "properties": { "action": { "description": "Action will always be `show_pin_entry_ui`\nshow_pin_entry_ui ContinueWithActionShowPINEntryUIString", "enum": [ "show_pin_entry_ui" ], "type": "string", "x-go-enum-desc": "show_pin_entry_ui ContinueWithActionShowPINEntryUIString" }, "data": { "allOf": [ { "$ref": "#/components/schemas/continueWithDeviceAuthnPinEntryUiData" } ], "description": "The one-time HPKE-sealed pin_secret material the device opens to bind the user's PIN after a PIN-protected DeviceAuthn enrollment or secret rotation." } }, "required": [ "action", "data" ], "title": "Instructs the client to show its PIN entry UI", "type": "object" }, "continueWithDeviceAuthnPinEntryUiData": { "description": "Contains the encapsulated key and the sealed ciphertext that the device\nopens with the X25519 transport private key it generated for this\nenrollment or rotation. Open it with HPKE (RFC 9180) using the suite\nDHKEM(X25519, HKDF-SHA256), HKDF-SHA256, AES-128-GCM, the ASCII info\nstring \"ory/deviceauthn/pin-secret/v1\", and the key's client_key_id (its\nASCII hex form) as the AAD.", "properties": { "ciphertext": { "description": "The base64-encoded HPKE ciphertext of the sealed pin_secret.", "type": "string" }, "enc": { "description": "The base64-encoded HPKE encapsulated key (the `enc` output of the seal\noperation).", "type": "string" } }, "required": [ "enc", "ciphertext" ], "title": "The one-time HPKE-sealed pin_secret material", "type": "object" }, "continueWithRecoveryUi": { "description": "Indicates, that the UI flow could be continued by showing a recovery ui", "properties": { "action": { "description": "Action will always be `show_recovery_ui`\nshow_recovery_ui ContinueWithActionShowRecoveryUIString", "enum": [ "show_recovery_ui" ], "type": "string", "x-go-enum-desc": "show_recovery_ui ContinueWithActionShowRecoveryUIString" }, "flow": { "$ref": "#/components/schemas/continueWithRecoveryUiFlow" } }, "required": [ "action", "flow" ], "type": "object" }, "continueWithRecoveryUiFlow": { "properties": { "id": { "description": "The ID of the recovery flow", "format": "uuid", "type": "string" }, "url": { "description": "The URL of the recovery flow\n\nIf this value is set, redirect the user's browser to this URL. This value is typically unset for native clients / API flows.", "type": "string" } }, "required": [ "id" ], "type": "object" }, "continueWithRedirectBrowserTo": { "description": "Indicates, that the UI flow could be continued by showing a recovery ui", "properties": { "action": { "description": "Action will always be `redirect_browser_to`\nredirect_browser_to ContinueWithActionRedirectBrowserToString", "enum": [ "redirect_browser_to" ], "type": "string", "x-go-enum-desc": "redirect_browser_to ContinueWithActionRedirectBrowserToString" }, "redirect_browser_to": { "description": "The URL to redirect the browser to", "type": "string" } }, "required": [ "action", "redirect_browser_to" ], "type": "object" }, "continueWithSetOrySessionToken": { "description": "Indicates that a session was issued, and the application should use this token for authenticated requests", "properties": { "action": { "description": "Action will always be `set_ory_session_token`\nset_ory_session_token ContinueWithActionSetOrySessionTokenString", "enum": [ "set_ory_session_token" ], "type": "string", "x-go-enum-desc": "set_ory_session_token ContinueWithActionSetOrySessionTokenString" }, "ory_session_token": { "description": "Token is the token of the session", "type": "string" } }, "required": [ "action", "ory_session_token" ], "type": "object" }, "continueWithSettingsUi": { "description": "Indicates, that the UI flow could be continued by showing a settings ui", "properties": { "action": { "description": "Action will always be `show_settings_ui`\nshow_settings_ui ContinueWithActionShowSettingsUIString", "enum": [ "show_settings_ui" ], "type": "string", "x-go-enum-desc": "show_settings_ui ContinueWithActionShowSettingsUIString" }, "flow": { "$ref": "#/components/schemas/continueWithSettingsUiFlow" } }, "required": [ "action", "flow" ], "type": "object" }, "continueWithSettingsUiFlow": { "properties": { "id": { "description": "The ID of the settings flow", "format": "uuid", "type": "string" }, "url": { "description": "The URL of the settings flow\n\nIf this value is set, redirect the user's browser to this URL. This value is typically unset for native clients / API flows.", "type": "string" } }, "required": [ "id" ], "type": "object" }, "continueWithVerificationUi": { "description": "Indicates, that the UI flow could be continued by showing a verification ui", "properties": { "action": { "description": "Action will always be `show_verification_ui`\nshow_verification_ui ContinueWithActionShowVerificationUIString", "enum": [ "show_verification_ui" ], "type": "string", "x-go-enum-desc": "show_verification_ui ContinueWithActionShowVerificationUIString" }, "flow": { "$ref": "#/components/schemas/continueWithVerificationUiFlow" } }, "required": [ "action", "flow" ], "type": "object" }, "continueWithVerificationUiFlow": { "properties": { "id": { "description": "The ID of the verification flow", "format": "uuid", "type": "string" }, "url": { "description": "The URL of the verification flow\n\nIf this value is set, redirect the user's browser to this URL. This value is typically unset for native clients / API flows.", "type": "string" }, "verifiable_address": { "description": "The address that should be verified in this flow", "type": "string" } }, "required": [ "id", "verifiable_address" ], "type": "object" }, "courierMessageStatus": { "description": "A Message's Status", "enum": [ "queued", "sent", "processing", "abandoned" ], "type": "string" }, "courierMessageType": { "description": "It can either be `email` or `phone`", "enum": [ "email", "phone" ], "title": "A Message's Type", "type": "string" }, "createCustomDomainBody": { "description": "Create Custom Hostname Request Body", "properties": { "cookie_domain": { "description": "The domain where cookies will be set. Has to be a parent domain of the custom hostname to work.", "type": "string" }, "cors_allowed_origins": { "description": "CORS Allowed origins for the custom hostname.", "items": { "type": "string" }, "type": "array" }, "cors_enabled": { "description": "CORS Enabled for the custom hostname.", "type": "boolean" }, "custom_ui_base_url": { "description": "The base URL where the custom user interface will be exposed.", "type": "string" }, "hostname": { "description": "The custom hostname where the API will be exposed.", "type": "string" } }, "type": "object" }, "createEventStreamBody": { "description": "Create Event Stream Request Body", "properties": { "https_endpoint": { "description": "The HTTPS endpoint URL to send events to. Required if type is https.", "type": "string" }, "role_arn": { "description": "The AWS IAM role ARN to assume when publishing to the SNS topic. Required if type is sns.", "type": "string" }, "status": { "description": "The status of the event stream. Defaults to active. A paused stream is\ncreated but does not forward any events until it is set to active.", "enum": [ "active", "paused" ], "type": "string" }, "topic_arn": { "description": "The AWS SNS topic ARN. Required if type is sns.", "type": "string" }, "type": { "description": "The type of the event stream (AWS SNS or HTTPS webhook).", "enum": [ "sns", "https" ], "type": "string" } }, "required": [ "type" ], "type": "object" }, "createFedcmFlowResponse": { "description": "Contains a list of all available FedCM providers.", "properties": { "csrf_token": { "type": "string" }, "providers": { "items": { "$ref": "#/components/schemas/Provider" }, "type": "array" } }, "title": "CreateFedcmFlowResponse", "type": "object" }, "createIdentityBody": { "description": "Create Identity Body", "properties": { "credentials": { "$ref": "#/components/schemas/identityWithCredentials" }, "external_id": { "description": "ExternalID is an optional external ID of the identity. This is used to link\nthe identity to an external system. If set, the external ID must be unique\nacross all identities.", "type": "string" }, "metadata_admin": { "description": "Store metadata about the user which is only accessible through admin APIs such as `GET /admin/identities/\u003cid\u003e`." }, "metadata_public": { "description": "Store metadata about the identity which the identity itself can see when calling for example the\nsession endpoint. Do not store sensitive information (e.g. credit score) about the identity in this field." }, "organization_id": { "$ref": "#/components/schemas/NullUUID" }, "recovery_addresses": { "description": "RecoveryAddresses contains all the addresses that can be used to recover an identity.\n\nUse this structure to import recovery addresses for an identity. Please keep in mind\nthat the address needs to be represented in the Identity Schema or this field will be overwritten\non the next identity update.", "items": { "$ref": "#/components/schemas/recoveryIdentityAddress" }, "type": "array" }, "region": { "description": "Region is the Ory Network region this identity will be created in.\nOptional; defaults to the project home region if omitted. Only effective\non the Ory Network.\neu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global", "enum": [ "eu-central", "asia-northeast", "us-east", "us-west", "eu", "asia", "us", "global" ], "type": "string", "x-go-enum-desc": "eu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global" }, "schema_id": { "description": "SchemaID is the ID of the JSON Schema to be used for validating the identity's traits.", "type": "string" }, "state": { "description": "State is the identity's state.\nactive StateActive\ninactive StateInactive", "enum": [ "active", "inactive" ], "type": "string", "x-go-enum-desc": "active StateActive\ninactive StateInactive" }, "traits": { "description": "Traits represent an identity's traits. The identity is able to create, modify, and delete traits\nin a self-service manner. The input will always be validated against the JSON Schema defined\nin `schema_url`.", "type": "object" }, "verifiable_addresses": { "description": "VerifiableAddresses contains all the addresses that can be verified by the user.\n\nUse this structure to import verified addresses for an identity. Please keep in mind\nthat the address needs to be represented in the Identity Schema or this field will be overwritten\non the next identity update.", "items": { "$ref": "#/components/schemas/verifiableIdentityAddress" }, "type": "array" } }, "required": [ "schema_id", "traits" ], "type": "object" }, "createJsonWebKeySet": { "description": "Create JSON Web Key Set Request Body", "properties": { "alg": { "description": "JSON Web Key Algorithm\n\nThe algorithm to be used for creating the key. Supports `RS256`, `ES256`, `ES512`, `HS512`, and `HS256`.", "type": "string" }, "kid": { "description": "JSON Web Key ID\n\nThe Key ID of the key to be created.", "type": "string" }, "use": { "description": "JSON Web Key Use\n\nThe \"use\" (public key use) parameter identifies the intended use of\nthe public key. The \"use\" parameter is employed to indicate whether\na public key is used for encrypting data or verifying the signature\non data. Valid values are \"enc\" and \"sig\".", "type": "string" } }, "required": [ "alg", "use", "kid" ], "type": "object" }, "createMemberInviteResponse": { "$ref": "#/components/schemas/CreateInviteResponse" }, "createOnboardingLinkBody": { "type": "object" }, "createOnboardingLinkResponse": { "properties": { "onboarding_portal_token": { "description": "The onboarding to redirect the user to for organization setup.", "type": "string" } }, "required": [ "onboarding_portal_token" ], "type": "object" }, "createOrganizationOnboardingPortalLinkBody": { "properties": { "apple_mapper_url": { "description": "AppleMapper specifies the JSONNet code snippet which uses Apple's\nprofile information to hydrate the identity's data.", "type": "string" }, "auth0_mapper_url": { "description": "Auth0Mapper specifies the JSONNet code snippet which uses Auth0's\nprofile information to hydrate the identity's data.", "type": "string" }, "custom_hostname_id": { "$ref": "#/components/schemas/NullUUID" }, "enable_scim": { "description": "Feature flag to enable SCIM configuration", "type": "boolean" }, "enable_sso": { "description": "Feature flag to enable SSO configuration", "type": "boolean" }, "expires_at": { "$ref": "#/components/schemas/Time" }, "facebook_mapper_url": { "description": "FacebookMapper specifies the JSONNet code snippet which uses Facebook's\nprofile information to hydrate the identity's data.", "type": "string" }, "generic_oidc_mapper_url": { "description": "GenericOIDCMapper specifies the JSONNet code snippet which uses the OIDC Provider's\nprofile information to hydrate the identity's data.", "type": "string" }, "github_mapper_url": { "description": "GithubMapper specifies the JSONNet code snippet which uses GitHub's\nprofile information to hydrate the identity's data.", "type": "string" }, "gitlab_mapper_url": { "description": "GitLabMapper specifies the JSONNet code snippet which uses GitLab's\nprofile information to hydrate the identity's data.", "type": "string" }, "google_mapper_url": { "description": "GoogleMapper specifies the JSONNet code snippet which uses Google's\nprofile information to hydrate the identity's data.", "type": "string" }, "microsoft_mapper_url": { "description": "MicrosoftMapper specifies the JSONNet code snippet which uses Microsoft's\nprofile information to hydrate the identity's data.", "type": "string" }, "netid_mapper_url": { "description": "NetIDMapper specifies the JSONNet code snippet which uses NetID's\nprofile information to hydrate the identity's data.", "type": "string" }, "proxy_acs_url": { "description": "Proxy ACS URL if overriding with a customer-controlled URL", "type": "string" }, "proxy_oidc_redirect_url": { "description": "Proxy OIDC Redirect URL if overriding with a customer-controlled URL", "type": "string" }, "proxy_saml_audience_override": { "description": "SAML Audience Override if overriding with a customer-controlled one", "type": "string" }, "proxy_scim_server_url": { "description": "Proxy SCIM Server URL if overriding with a customer-controlled URL", "type": "string" }, "saml_mapper_url": { "description": "SAMLMapper specifies the JSONNet code snippet which uses the SAML Provider's\nprofile information to hydrate the identity's data.", "type": "string" }, "scim_mapper_url": { "description": "SCIMMapper specifies the JSONNet code snippet which uses the SCIM Provider's\nprofile information to hydrate the identity's data.", "type": "string" } }, "required": [ "enable_sso", "enable_scim" ], "type": "object" }, "createProjectApiKeyBody": { "properties": { "expires_at": { "$ref": "#/components/schemas/Time" }, "name": { "description": "The Token Name\n\nA descriptive name for the token.", "type": "string" } }, "required": [ "name" ], "type": "object" }, "createProjectBody": { "description": "Create Project Request Body", "properties": { "environment": { "description": "The environment of the project.\nprod Production\nstage Staging\ndev Development", "enum": [ "prod", "stage", "dev" ], "type": "string", "x-go-enum-desc": "prod Production\nstage Staging\ndev Development" }, "home_region": { "description": "Home Region\n\nThe home region of the project. This is the region where the project will be created.\neu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global", "enum": [ "eu-central", "asia-northeast", "us-east", "us-west", "eu", "asia", "us", "global" ], "type": "string", "x-go-enum-desc": "eu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global" }, "name": { "description": "The name of the project to be created", "type": "string" }, "workspace_id": { "description": "The workspace to create the project in.", "format": "uuid", "type": "string" } }, "required": [ "name", "environment" ], "type": "object" }, "createProjectBranding": { "description": "Create a Project Branding", "properties": { "favicon_type": { "type": "string" }, "favicon_url": { "type": "string" }, "logo_type": { "type": "string" }, "logo_url": { "type": "string" }, "name": { "type": "string" }, "theme": { "$ref": "#/components/schemas/projectBrandingColors" } }, "type": "object" }, "createRecoveryCodeForIdentityBody": { "description": "Create Recovery Code for Identity Request Body", "properties": { "expires_in": { "description": "Code Expires In\n\nThe recovery code will expire after that amount of time has passed. Defaults to the configuration value of\n`selfservice.methods.code.config.lifespan`.", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "flow_type": { "$ref": "#/components/schemas/selfServiceFlowType" }, "identity_id": { "description": "Identity to Recover\n\nThe identity's ID you wish to recover.", "format": "uuid", "type": "string" } }, "required": [ "identity_id" ], "type": "object" }, "createRecoveryLinkForIdentityBody": { "description": "Create Recovery Link for Identity Request Body", "properties": { "expires_in": { "description": "Link Expires In\n\nThe recovery link will expire after that amount of time has passed. Defaults to the configuration value of\n`selfservice.methods.code.config.lifespan`.", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "identity_id": { "description": "Identity to Recover\n\nThe identity's ID you wish to recover.", "format": "uuid", "type": "string" } }, "required": [ "identity_id" ], "type": "object" }, "createRelationshipBody": { "description": "Create Relationship Request Body", "properties": { "namespace": { "description": "Namespace to query", "type": "string" }, "object": { "description": "Object to query", "type": "string" }, "relation": { "description": "Relation to query", "type": "string" }, "subject_id": { "description": "SubjectID to query\n\nEither SubjectSet or SubjectID can be provided.", "type": "string" }, "subject_set": { "$ref": "#/components/schemas/subjectSet" } }, "type": "object" }, "createSubscriptionBody": { "properties": { "currency": { "description": "\nusd USD\neur Euro", "enum": [ "usd", "eur" ], "type": "string", "x-go-enum-desc": "usd USD\neur Euro" }, "interval": { "description": "\nmonthly Monthly\nyearly Yearly", "enum": [ "monthly", "yearly" ], "type": "string", "x-go-enum-desc": "monthly Monthly\nyearly Yearly" }, "plan": { "type": "string" }, "provision_first_project": { "format": "uuid", "type": "string" }, "return_to": { "type": "string" } }, "required": [ "plan", "interval", "provision_first_project" ], "type": "object" }, "createTestLoginFlowBody": { "properties": { "provider_id": { "description": "ID of the OIDC provider to test. Must match a provider configured on\nthe project that serves this request.", "maxLength": 255, "type": "string" } }, "required": [ "provider_id" ], "title": "Request body for creating a test OIDC login flow.", "type": "object" }, "createTestLoginFlowFromOnboardingPortalLinkBody": { "description": "Request body for starting a dry-run OIDC test login flow from an onboarding\nportal link.", "properties": { "provider_id": { "description": "ID of the OIDC provider to test. Must match a provider configured on\nthe link's organization.", "maxLength": 255, "type": "string" } }, "required": [ "provider_id" ], "type": "object" }, "createWorkspaceBody": { "properties": { "name": { "description": "The name of the workspace", "type": "string" } }, "required": [ "name" ], "type": "object" }, "createWorkspaceOrganizationBody": { "properties": { "generic_oidc_provider": { "$ref": "#/components/schemas/GenericOIDCProvider" } }, "type": "object" }, "createWorkspaceSubscriptionBody": { "properties": { "currency": { "description": "\nusd USD\neur Euro", "enum": [ "usd", "eur" ], "type": "string", "x-go-enum-desc": "usd USD\neur Euro" }, "interval": { "description": "\nmonthly Monthly\nyearly Yearly", "enum": [ "monthly", "yearly" ], "type": "string", "x-go-enum-desc": "monthly Monthly\nyearly Yearly" }, "plan": { "type": "string" }, "return_to": { "type": "string" } }, "required": [ "plan", "interval" ], "type": "object" }, "credentialSupportedDraft00": { "description": "Includes information about the supported verifiable credentials.", "properties": { "cryptographic_binding_methods_supported": { "description": "OpenID Connect Verifiable Credentials Cryptographic Binding Methods Supported\n\nContains a list of cryptographic binding methods supported for signing the proof.", "items": { "type": "string" }, "type": "array" }, "cryptographic_suites_supported": { "description": "OpenID Connect Verifiable Credentials Cryptographic Suites Supported\n\nContains a list of cryptographic suites methods supported for signing the proof.", "items": { "type": "string" }, "type": "array" }, "format": { "description": "OpenID Connect Verifiable Credentials Format\n\nContains the format that is supported by this authorization server.", "type": "string" }, "types": { "description": "OpenID Connect Verifiable Credentials Types\n\nContains the types of verifiable credentials supported.", "items": { "type": "string" }, "type": "array" } }, "title": "Verifiable Credentials Metadata (Draft 00)", "type": "object" }, "customDomain": { "description": "Custom Hostname", "properties": { "cookie_domain": { "type": "string" }, "cors_allowed_origins": { "items": { "type": "string" }, "type": "array" }, "cors_enabled": { "type": "boolean" }, "created_at": { "format": "date-time", "type": "string" }, "custom_ui_base_url": { "type": "string" }, "hostname": { "type": "string" }, "id": { "format": "uuid", "type": "string" }, "ssl_status": { "enum": [ "initializing", "pending_validation", "deleted", "pending_issuance", "pending_deployment", "pending_deletion", "pending_expiration", "expired", "active", "initializing_timed_out", "validation_timed_out", "issuance_timed_out", "deployment_timed_out", "deletion_timed_out", "pending_cleanup", "staging_deployment", "staging_active", "deactivating", "inactive", "backup_issued", "holding_deployment", "" ], "type": "string", "x-go-enum-desc": "initializing _\npending_validation _\ndeleted _\npending_issuance _\npending_deployment _\npending_deletion _\npending_expiration _\nexpired _\nactive _\ninitializing_timed_out _\nvalidation_timed_out _\nissuance_timed_out _\ndeployment_timed_out _\ndeletion_timed_out _\npending_cleanup _\nstaging_deployment _\nstaging_active _\ndeactivating _\ninactive _\nbackup_issued _\nholding_deployment _\n _ Cloudflare sometimes returns an empty string." }, "updated_at": { "format": "date-time", "type": "string" }, "verification_errors": { "items": { "type": "string" }, "type": "array" }, "verification_status": { "type": "string" } }, "type": "object" }, "customerPortalAvailability": { "description": "CustomerPortalAvailability describes whether the Stripe customer portal is\navailable for the logged-in user (or a workspace they access).", "properties": { "available": { "description": "Whether the customer portal is available.", "type": "boolean" }, "reason": { "description": "Optional reason why the portal is unavailable. Populated only when\n`available` is false. For debugging and support purposes — frontend\nconsumers should not parse or depend on specific values.\nno_stripe_customer CustomerPortalReasonNoStripeCustomer\nno_subscription CustomerPortalReasonNoSubscription", "enum": [ "no_stripe_customer", "no_subscription" ], "type": "string", "x-go-enum-desc": "no_stripe_customer CustomerPortalReasonNoStripeCustomer\nno_subscription CustomerPortalReasonNoSubscription" } }, "required": [ "available" ], "type": "object" }, "deleteMySessionsCount": { "description": "Deleted Session Count", "properties": { "count": { "description": "The number of sessions that were revoked.", "format": "int64", "type": "integer" } }, "type": "object" }, "deviceAuthnAndroidAuthorizationList": { "description": "Schema: https://source.android.com/docs/security/features/keystore/attestation#schema", "properties": { "active_date_time": { "format": "int64", "type": "integer" }, "algorithm": { "format": "int64", "type": "integer" }, "application_id": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "attestation_application_id": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "attestation_id_brand": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "attestation_id_device": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "attestation_id_imei": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "attestation_id_manufacturer": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "attestation_id_meid": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "attestation_id_model": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "attestation_id_product": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "attestation_id_serial": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "auth_timeout": { "format": "int64", "type": "integer" }, "boot_patch_level": { "format": "int64", "type": "integer" }, "creation_date_time": { "format": "int64", "type": "integer" }, "digest": { "items": { "format": "int64", "type": "integer" }, "type": "array" }, "ec_curve": { "format": "int64", "type": "integer" }, "key_size": { "format": "int64", "type": "integer" }, "origin": { "format": "int64", "type": "integer" }, "origination_expire_date_time": { "format": "int64", "type": "integer" }, "os_patch_level": { "format": "int64", "type": "integer" }, "os_version": { "format": "int64", "type": "integer" }, "purpose": { "items": { "format": "int64", "type": "integer" }, "type": "array" }, "root_of_trust": { "$ref": "#/components/schemas/deviceAuthnAndroidRootOfTrust" }, "usage_expire_date_time": { "format": "int64", "type": "integer" }, "user_auth_type": { "format": "int64", "type": "integer" }, "vendor_patch_level": { "format": "int64", "type": "integer" } }, "title": "AndroidAuthorizationList maps the ASN.1 tags to the fields defined in KeyMint 4.", "type": "object" }, "deviceAuthnAndroidKeyDescription": { "description": "Schema: https://source.android.com/docs/security/features/keystore/attestation#schema", "properties": { "attestation_security_level": { "$ref": "#/components/schemas/Enumerated" }, "attestation_version": { "format": "int64", "type": "integer" }, "keymaster_security_level": { "$ref": "#/components/schemas/Enumerated" }, "keymaster_version": { "format": "int64", "type": "integer" }, "software_enforced": { "$ref": "#/components/schemas/deviceAuthnAndroidAuthorizationList" }, "tee_enforced": { "$ref": "#/components/schemas/deviceAuthnAndroidAuthorizationList" } }, "title": "AndroidKeyDescription matches the ASN.1 sequence defined by Android.\nIt is stored in the leaf certificate's x509 extension.", "type": "object" }, "deviceAuthnAndroidRootOfTrust": { "properties": { "device_locked": { "type": "boolean" }, "verified_boot_hash": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "verified_boot_key": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "verified_boot_state": { "$ref": "#/components/schemas/Enumerated" } }, "type": "object" }, "deviceAuthnAttestation": { "description": "Exactly one of `android` or `ios` is set, matching the key's device_type.", "properties": { "android": { "$ref": "#/components/schemas/deviceAuthnAndroidKeyDescription" }, "ios": { "$ref": "#/components/schemas/deviceAuthnIOSAttestation" } }, "title": "Attestation holds the platform-specific attestation parsed at enrollment.", "type": "object" }, "deviceAuthnIOSAttStmt": { "description": "Defined in https://developer.apple.com/documentation/devicecheck/validating-apps-that-connect-to-your-server#Verify-the-attestation .", "properties": { "x5c": { "description": "X5c is the leaf-first certificate chain encoded as base64(DER), per\nthe JOSE convention defined in RFC 7515 §4.1.6.", "items": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "type": "array" } }, "title": "IOSAttStmt is the attestation statement of an Apple App Attest attestation.", "type": "object" }, "deviceAuthnIOSAttestation": { "description": "Defined in https://developer.apple.com/documentation/devicecheck/validating-apps-that-connect-to-your-server#Verify-the-attestation .", "properties": { "att_stmt": { "$ref": "#/components/schemas/deviceAuthnIOSAttStmt" }, "auth_data": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "fmt": { "type": "string" } }, "title": "IOSAttestation is an Apple App Attest attestation.", "type": "object" }, "deviceAuthorization": { "description": "# Ory's OAuth 2.0 Device Authorization API", "properties": { "device_code": { "description": "The device verification code.", "example": "ory_dc_smldfksmdfkl.mslkmlkmlk", "type": "string" }, "expires_in": { "description": "The lifetime in seconds of the \"device_code\" and \"user_code\".", "example": 16830, "format": "int64", "type": "integer" }, "interval": { "description": "The minimum amount of time in seconds that the client\nSHOULD wait between polling requests to the token endpoint. If no\nvalue is provided, clients MUST use 5 as the default.", "example": 5, "format": "int64", "type": "integer" }, "user_code": { "description": "The end-user verification code.", "example": "AAAAAA", "type": "string" }, "verification_uri": { "description": "The end-user verification URI on the authorization\nserver. The URI should be short and easy to remember as end users\nwill be asked to manually type it into their user agent.", "example": "https://auth.ory.sh/tv", "type": "string" }, "verification_uri_complete": { "description": "A verification URI that includes the \"user_code\" (or\nother information with the same function as the \"user_code\"),\nwhich is designed for non-textual transmission.", "example": "https://auth.ory.sh/tv?user_code=AAAAAA", "type": "string" } }, "title": "OAuth2 Device Flow", "type": "object" }, "elementsConfiguration": { "description": "ElementsConfiguration is the subset of a project's configuration that Ory\nElements consumes to customize its behavior and appearance. It mirrors the\n`ProjectConfiguration` type in `@ory/elements-react` and intentionally omits\naccount-experience-only fields (stylesheet, locales, translations, favicons).", "properties": { "contact_url": { "description": "The URL to the project's Contact page.", "type": "string" }, "default_redirect_url": { "description": "The default redirect URL.", "type": "string" }, "error_ui_url": { "description": "The URL for the error UI.", "type": "string" }, "hide_ory_branding": { "description": "Whether to hide the Ory branding badge.", "type": "boolean" }, "hide_registration_link": { "description": "Whether to hide the \"Sign up\" link on the login card footer.", "type": "boolean" }, "login_ui_url": { "description": "The URL for the login UI.", "type": "string" }, "logo_dark_url": { "description": "The URL for the dark logo.", "type": "string" }, "logo_light_url": { "description": "The URL for the light logo on the auth card.", "type": "string" }, "name": { "description": "The name of the project displayed on the auth card.", "type": "string" }, "privacy_policy_url": { "description": "The URL to the project's Privacy Policy page.", "type": "string" }, "recovery_enabled": { "description": "Whether recovery is enabled.", "type": "boolean" }, "recovery_ui_url": { "description": "The URL for the recovery UI.", "type": "string" }, "registration_enabled": { "description": "Whether registration is enabled.", "type": "boolean" }, "registration_ui_url": { "description": "The URL for the registration UI.", "type": "string" }, "settings_ui_url": { "description": "The URL for the settings UI.", "type": "string" }, "terms_of_service_url": { "description": "The URL to the project's Terms of Service page.", "type": "string" }, "verification_enabled": { "description": "Whether verification is enabled.", "type": "boolean" }, "verification_ui_url": { "description": "The URL for the verification UI.", "type": "string" } }, "required": [ "name", "registration_enabled", "hide_registration_link", "verification_enabled", "recovery_enabled", "login_ui_url", "registration_ui_url", "recovery_ui_url", "verification_ui_url", "settings_ui_url", "error_ui_url", "default_redirect_url", "hide_ory_branding" ], "type": "object" }, "emailTemplateData": { "description": "Contains the data of the email template, including the subject and body in HTML and plaintext variants", "properties": { "body": { "$ref": "#/components/schemas/emailTemplateDataBody" }, "subject": { "type": "string" } }, "required": [ "body", "subject" ], "type": "object" }, "emailTemplateDataBody": { "properties": { "html": { "type": "string" }, "plaintext": { "type": "string" } }, "required": [ "html", "plaintext" ], "type": "object" }, "errorAuthenticatorAssuranceLevelNotSatisfied": { "properties": { "error": { "$ref": "#/components/schemas/genericError" }, "redirect_browser_to": { "description": "Points to where to redirect the user to next.", "type": "string" } }, "title": "Is returned when an active session was found but the requested AAL is not satisfied.", "type": "object" }, "errorBrowserLocationChangeRequired": { "properties": { "error": { "$ref": "#/components/schemas/errorGeneric" }, "redirect_browser_to": { "description": "Points to where to redirect the user to next.", "type": "string" } }, "title": "Is sent when a flow requires a browser to change its location.", "type": "object" }, "errorFlowReplaced": { "description": "Is sent when a flow is replaced by a different flow of the same class", "properties": { "error": { "$ref": "#/components/schemas/genericError" }, "use_flow_id": { "description": "The flow ID that should be used for the new flow as it contains the correct messages.", "format": "uuid", "type": "string" } }, "type": "object" }, "errorGeneric": { "description": "The standard Ory JSON API error format.", "properties": { "error": { "$ref": "#/components/schemas/genericErrorContent" } }, "required": [ "error" ], "title": "JSON API Error Response", "type": "object" }, "errorOAuth2": { "description": "Error", "properties": { "error": { "description": "Error", "type": "string" }, "error_debug": { "description": "Error Debug Information\n\nOnly available in dev mode.", "type": "string" }, "error_description": { "description": "Error Description", "type": "string" }, "error_hint": { "description": "Error Hint\n\nHelps the user identify the error cause.", "example": "The redirect URL is not allowed.", "type": "string" }, "status_code": { "description": "HTTP Status Code", "example": 401, "format": "int64", "type": "integer" } }, "type": "object" }, "eventStream": { "description": "Event Stream", "properties": { "created_at": { "format": "date-time", "type": "string" }, "https_endpoint": { "$ref": "#/components/schemas/String" }, "id": { "format": "uuid", "type": "string" }, "role_arn": { "type": "string" }, "status": { "description": "The status of the event stream. A paused event stream does not forward\nany events until it is set back to active.", "enum": [ "active", "paused" ], "type": "string" }, "topic_arn": { "type": "string" }, "type": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "type": "object" }, "expandedPermissionTree": { "properties": { "children": { "description": "The children of the node, possibly none.", "items": { "$ref": "#/components/schemas/expandedPermissionTree" }, "type": "array" }, "tuple": { "$ref": "#/components/schemas/relationship" }, "type": { "description": "The type of the node.\nunion TreeNodeUnion\nexclusion TreeNodeExclusion\nintersection TreeNodeIntersection\nleaf TreeNodeLeaf\ntuple_to_subject_set TreeNodeTupleToSubjectSet\ncomputed_subject_set TreeNodeComputedSubjectSet\nnot TreeNodeNot\nunspecified TreeNodeUnspecified", "enum": [ "union", "exclusion", "intersection", "leaf", "tuple_to_subject_set", "computed_subject_set", "not", "unspecified" ], "type": "string", "x-go-enum-desc": "union TreeNodeUnion\nexclusion TreeNodeExclusion\nintersection TreeNodeIntersection\nleaf TreeNodeLeaf\ntuple_to_subject_set TreeNodeTupleToSubjectSet\ncomputed_subject_set TreeNodeComputedSubjectSet\nnot TreeNodeNot\nunspecified TreeNodeUnspecified" } }, "required": [ "type" ], "type": "object" }, "falsyNullBool": { "description": "It JSON decodes to false if null.", "title": "FalsyNullBool represents a bool that may be null.", "type": "boolean" }, "flowError": { "properties": { "created_at": { "description": "CreatedAt is a helper struct field for gobuffalo.pop.", "format": "date-time", "type": "string" }, "error": { "type": "object" }, "id": { "description": "ID of the error container.", "format": "uuid", "type": "string" }, "updated_at": { "description": "UpdatedAt is a helper struct field for gobuffalo.pop.", "format": "date-time", "type": "string" } }, "required": [ "id" ], "type": "object" }, "genericError": { "description": "Error responses are sent when an error (e.g. unauthorized, bad request, ...) occurred.", "properties": { "code": { "description": "The status code", "example": 404, "format": "int64", "type": "integer" }, "debug": { "description": "Debug information\n\nThis field is often not exposed to protect against leaking\nsensitive information.", "example": "SQL field \"foo\" is not a bool.", "type": "string" }, "details": { "description": "Further error details" }, "error": { "$ref": "#/components/schemas/genericErrorContent" }, "id": { "description": "The error ID\n\nUseful when trying to identify various errors in application logic.", "type": "string" }, "message": { "description": "Error message\n\nThe error's message.", "example": "The resource could not be found", "type": "string" }, "reason": { "description": "A human-readable reason for the error", "example": "User with ID 1234 does not exist.", "type": "string" }, "request": { "description": "The request ID\n\nThe request ID is often exposed internally in order to trace\nerrors across service architectures. This is often a UUID.", "example": "d7ef54b1-ec15-46e6-bccb-524b82c035e6", "type": "string" }, "status": { "description": "The status description", "example": "Not Found", "type": "string" } }, "required": [ "message" ], "title": "Error response", "type": "object" }, "genericErrorContent": { "description": "Error response", "properties": { "debug": { "description": "Debug contains debug information. This is usually not available and has to be enabled.", "example": "The database adapter was unable to find the element", "type": "string" }, "error": { "description": "Name is the error name.", "example": "The requested resource could not be found", "type": "string" }, "error_description": { "description": "Description contains further information on the nature of the error.", "example": "Object with ID 12345 does not exist", "type": "string" }, "id": { "description": "ID is a unique error ID.\nfeature_not_available ErrFeatureNotAvailable\nquota_exceeded ErrQuotaExceeded", "enum": [ "feature_not_available", "quota_exceeded" ], "type": "string", "x-go-enum-desc": "feature_not_available ErrFeatureNotAvailable\nquota_exceeded ErrQuotaExceeded" }, "message": { "description": "Message contains the error message.", "type": "string" }, "status_code": { "description": "Code represents the error status code (404, 403, 401, ...).", "example": 404, "format": "int64", "type": "integer" } }, "type": "object" }, "getAttributesCount": { "description": "Response of the getAttributesCount endpoint", "properties": { "data": { "description": "The list of data points.", "items": { "$ref": "#/components/schemas/AttributesCountDatapoint" }, "readOnly": true, "type": "array" } }, "required": [ "data" ], "type": "object" }, "getManagedIdentitySchemaLocation": { "description": "Ory Identity Schema Location", "properties": { "location": { "type": "string" } }, "type": "object" }, "getMetricsCount": { "description": "Response of the getIdentityCount endpoint", "properties": { "count": { "description": "The total count", "format": "int64", "readOnly": true, "type": "integer" }, "service_name": { "description": "Helper field to identify the service used for this response", "readOnly": true, "type": "string" } }, "required": [ "count", "service_name" ], "type": "object" }, "getMetricsEventAttributes": { "description": "Response of the getMetricsEventAttributes endpoint", "properties": { "events": { "description": "The list of data points.", "items": { "type": "string" }, "readOnly": true, "type": "array" } }, "required": [ "events" ], "type": "object" }, "getMetricsEventTypes": { "description": "Response of the getMetricsEventTypes endpoint", "properties": { "events": { "description": "The list of data points.", "items": { "type": "string" }, "readOnly": true, "type": "array" } }, "required": [ "events" ], "type": "object" }, "getOrganizationResponse": { "properties": { "organization": { "$ref": "#/components/schemas/organization" } }, "required": [ "organization" ], "title": "getOrganizationResponse represents a B2B SSO Organization.", "type": "object" }, "getOrganizationsByHostnameResponse": { "description": "getOrganizationsByHostnameResponse is the list of B2B SSO organizations for\nthe project resolved from the request host.", "properties": { "organizations": { "description": "Organizations is the list of organizations for the project.", "items": { "$ref": "#/components/schemas/organizationByHostname" }, "type": "array" } }, "required": [ "organizations" ], "type": "object" }, "getProjectEvents": { "description": "Response of the getProjectEvents endpoint", "properties": { "events": { "description": "The list of data points.", "items": { "$ref": "#/components/schemas/ProjectEventsDatapoint" }, "readOnly": true, "type": "array" }, "page_token": { "description": "Pagination token to be included in next page request", "readOnly": true, "type": "string" } }, "required": [ "events" ], "type": "object" }, "getProjectEventsBody": { "description": "Body of the getProjectEvents endpoint", "properties": { "event_name": { "description": "The event name to query for", "type": "string" }, "filters": { "default": [], "description": "Event attribute filters", "items": { "$ref": "#/components/schemas/AttributeFilter" }, "type": "array" }, "from": { "description": "The start RFC3339 date of the time window", "format": "date-time", "type": "string" }, "page_size": { "default": 25, "description": "Maximum number of events to return", "format": "int64", "type": "integer" }, "page_token": { "description": "Pagination token to fetch next page, empty if first page", "type": "string" }, "to": { "description": "The end RFC3339 date of the time window", "format": "date-time", "type": "string" } }, "required": [ "from", "to" ], "type": "object" }, "getProjectMetrics": { "description": "Response of the getMetrics endpoint", "properties": { "data": { "description": "The list of data points.", "items": { "$ref": "#/components/schemas/metricsDatapoint" }, "readOnly": true, "type": "array" } }, "required": [ "data" ], "type": "object" }, "getSessionActivity": { "description": "Response of the getSessionActivity endpoint", "properties": { "data": { "description": "The list of data points.", "items": { "$ref": "#/components/schemas/SessionActivityDatapoint" }, "readOnly": true, "type": "array" } }, "required": [ "data" ], "type": "object" }, "healthNotReadyStatus": { "properties": { "errors": { "additionalProperties": { "type": "string" }, "description": "Errors contains a list of errors that caused the not ready status.", "type": "object" } }, "title": "The not ready status of the service.", "type": "object" }, "healthStatus": { "properties": { "status": { "description": "Status always contains \"ok\".", "type": "string" } }, "title": "The health status of the service.", "type": "object" }, "identity": { "description": "An [identity](https://www.ory.com/docs/kratos/concepts/identity-user-model) represents a (human) user in Ory.", "properties": { "created_at": { "description": "CreatedAt is a helper struct field for gobuffalo.pop.", "format": "date-time", "type": "string" }, "credentials": { "additionalProperties": { "$ref": "#/components/schemas/identityCredentials" }, "description": "Credentials represents all credentials that can be used for authenticating this identity.", "type": "object" }, "external_id": { "description": "ExternalID is an optional external ID of the identity. This is used to link\nthe identity to an external system. If set, the external ID must be unique\nacross all identities.", "type": "string" }, "id": { "description": "ID is the identity's unique identifier.\n\nThe Identity ID can not be changed and can not be chosen. This ensures future\ncompatibility and optimization for distributed stores such as CockroachDB.", "format": "uuid", "type": "string" }, "metadata_admin": { "$ref": "#/components/schemas/nullJsonRawMessage" }, "metadata_public": { "$ref": "#/components/schemas/nullJsonRawMessage" }, "organization_id": { "$ref": "#/components/schemas/NullUUID" }, "recovery_addresses": { "description": "RecoveryAddresses contains all the addresses that can be used to recover an identity.", "items": { "$ref": "#/components/schemas/recoveryIdentityAddress" }, "type": "array", "x-omitempty": true }, "region": { "description": "Region is the Ory Network region this identity is homed in. Set by\nthe multi-region persister; empty on OSS and single-region deployments.\neu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global", "enum": [ "eu-central", "asia-northeast", "us-east", "us-west", "eu", "asia", "us", "global" ], "type": "string", "x-go-enum-desc": "eu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global" }, "schema_id": { "description": "SchemaID is the ID of the JSON Schema to be used for validating the identity's traits.", "type": "string" }, "schema_url": { "description": "SchemaURL is the URL of the endpoint where the identity's traits schema can be fetched from.\n\nformat: url", "type": "string" }, "state": { "description": "State is the identity's state.\n\nThis value has currently no effect.\nactive StateActive\ninactive StateInactive", "enum": [ "active", "inactive" ], "type": "string", "x-go-enum-desc": "active StateActive\ninactive StateInactive" }, "state_changed_at": { "$ref": "#/components/schemas/nullTime" }, "traits": { "$ref": "#/components/schemas/identityTraits" }, "updated_at": { "description": "UpdatedAt is a helper struct field for gobuffalo.pop.", "format": "date-time", "type": "string" }, "verifiable_addresses": { "description": "VerifiableAddresses contains all the addresses that can be verified by the user.", "items": { "$ref": "#/components/schemas/verifiableIdentityAddress" }, "type": "array", "x-omitempty": true } }, "required": [ "id", "schema_id", "schema_url", "traits" ], "title": "Identity represents an Ory Kratos identity", "type": "object" }, "identityCredentials": { "description": "Credentials represents a specific credential type", "properties": { "config": { "$ref": "#/components/schemas/JSONRawMessage" }, "created_at": { "description": "CreatedAt is a helper struct field for gobuffalo.pop.", "format": "date-time", "type": "string" }, "identifiers": { "description": "Identifiers represent a list of unique identifiers this credential type matches.", "items": { "type": "string" }, "type": "array" }, "type": { "description": "Type discriminates between different types of credentials.\npassword CredentialsTypePassword\noidc CredentialsTypeOIDC\ntotp CredentialsTypeTOTP\nlookup_secret CredentialsTypeLookup\nwebauthn CredentialsTypeWebAuthn\ncode CredentialsTypeCodeAuth\npasskey CredentialsTypePasskey\nprofile CredentialsTypeProfile\nsaml CredentialsTypeSAML\ndeviceauthn CredentialsTypeDeviceAuthn\nidentifier_first CredentialsTypeIdentifierFirst\nlink_recovery CredentialsTypeRecoveryLink CredentialsTypeRecoveryLink is a special credential type linked to the link strategy (recovery flow). It is not used within the credentials object itself.\ncode_recovery CredentialsTypeRecoveryCode", "enum": [ "password", "oidc", "totp", "lookup_secret", "webauthn", "code", "passkey", "profile", "saml", "deviceauthn", "identifier_first", "link_recovery", "code_recovery" ], "type": "string", "x-go-enum-desc": "password CredentialsTypePassword\noidc CredentialsTypeOIDC\ntotp CredentialsTypeTOTP\nlookup_secret CredentialsTypeLookup\nwebauthn CredentialsTypeWebAuthn\ncode CredentialsTypeCodeAuth\npasskey CredentialsTypePasskey\nprofile CredentialsTypeProfile\nsaml CredentialsTypeSAML\ndeviceauthn CredentialsTypeDeviceAuthn\nidentifier_first CredentialsTypeIdentifierFirst\nlink_recovery CredentialsTypeRecoveryLink CredentialsTypeRecoveryLink is a special credential type linked to the link strategy (recovery flow). It is not used within the credentials object itself.\ncode_recovery CredentialsTypeRecoveryCode" }, "updated_at": { "description": "UpdatedAt is a helper struct field for gobuffalo.pop.", "format": "date-time", "type": "string" }, "version": { "description": "Version refers to the version of the credential. Useful when changing the config schema.", "format": "int64", "type": "integer" } }, "type": "object" }, "identityCredentialsCode": { "description": "CredentialsCode represents a one time login/registration code", "properties": { "addresses": { "items": { "$ref": "#/components/schemas/identityCredentialsCodeAddress" }, "type": "array" } }, "type": "object" }, "identityCredentialsCodeAddress": { "properties": { "address": { "description": "The address for this code", "type": "string" }, "channel": { "$ref": "#/components/schemas/CodeChannel" } }, "type": "object" }, "identityCredentialsLookupSecretCode": { "description": "Recovery codes can be used once and are invalidated after use.", "properties": { "code": { "description": "A recovery code", "type": "string" }, "used_at": { "$ref": "#/components/schemas/nullTime" } }, "title": "RecoveryCode represents one recovery code associated with a lookup_secret credential.", "type": "object" }, "identityCredentialsOidc": { "properties": { "providers": { "items": { "$ref": "#/components/schemas/identityCredentialsOidcProvider" }, "type": "array" } }, "title": "CredentialsOIDC is contains the configuration for credentials of the type oidc.", "type": "object" }, "identityCredentialsOidcProvider": { "properties": { "initial_access_token": { "type": "string" }, "initial_id_token": { "type": "string" }, "initial_refresh_token": { "type": "string" }, "organization": { "type": "string" }, "provider": { "type": "string" }, "subject": { "type": "string" }, "use_auto_link": { "type": "boolean" } }, "title": "CredentialsOIDCProvider is contains a specific OpenID COnnect credential for a particular connection (e.g. Google).", "type": "object" }, "identityCredentialsPassword": { "properties": { "hashed_password": { "description": "HashedPassword is a hash-representation of the password.", "type": "string" }, "use_password_migration_hook": { "description": "UsePasswordMigrationHook is set to true if the password should be migrated\nusing the password migration hook. If set, and the HashedPassword is empty, a\nwebhook will be called during login to migrate the password.", "type": "boolean" } }, "title": "CredentialsPassword is contains the configuration for credentials of the type password.", "type": "object" }, "identityCredentialsWebAuthn": { "properties": { "added_at": { "format": "date-time", "type": "string" }, "attestation": { "$ref": "#/components/schemas/identityCredentialsWebAuthnAttestation" }, "attestation_type": { "type": "string" }, "authenticator": { "$ref": "#/components/schemas/identityCredentialsWebAuthnAuthenticator" }, "display_name": { "type": "string" }, "flags": { "$ref": "#/components/schemas/identityCredentialsWebAuthnFlags" }, "id": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "is_passwordless": { "type": "boolean" }, "public_key": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "transport": { "items": { "$ref": "#/components/schemas/AuthenticatorTransport" }, "type": "array" } }, "title": "CredentialWebAuthn contains information about a webauthn credential.", "type": "object" }, "identityCredentialsWebAuthnAttestation": { "properties": { "authenticator_data": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "client_dataJSON": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "client_data_hash": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "object": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "public_key_algorithm": { "format": "int64", "type": "integer" } }, "title": "CredentialWebAuthnAttestation contains information about attestation of a webauthn credential.", "type": "object" }, "identityCredentialsWebAuthnAuthenticator": { "properties": { "aaguid": { "items": { "format": "uint8", "type": "integer" }, "type": "array" }, "clone_warning": { "type": "boolean" }, "sign_count": { "format": "uint32", "type": "integer" } }, "title": "AuthenticatorWebAuthn contains information about the authenticator of a webauthn credential.", "type": "object" }, "identityCredentialsWebAuthnFlags": { "properties": { "backup_eligible": { "type": "boolean" }, "backup_state": { "type": "boolean" }, "user_present": { "type": "boolean" }, "user_verified": { "type": "boolean" } }, "title": "CredentialWebAuthnFlags contains information about the flags of a webauthn credential.", "type": "object" }, "identityCredentialsWebAuthnList": { "items": { "$ref": "#/components/schemas/identityCredentialsWebAuthn" }, "type": "array" }, "identityMetaSchema": { "description": "Identity Meta Schema", "type": "object" }, "identityPatch": { "description": "Payload for patching an identity", "properties": { "create": { "$ref": "#/components/schemas/createIdentityBody" }, "patch_id": { "description": "The ID of this patch.\n\nThe patch ID is optional. If specified, the ID will be returned in the\nresponse, so consumers of this API can correlate the response with the\npatch.", "format": "uuid", "type": "string" } }, "type": "object" }, "identityPatchResponse": { "description": "Response for a single identity patch", "properties": { "action": { "description": "The action for this specific patch\ncreate ActionCreate Create this identity.\nerror ActionError Error indicates that the patch failed.", "enum": [ "create", "error" ], "type": "string", "x-go-enum-desc": "create ActionCreate Create this identity.\nerror ActionError Error indicates that the patch failed." }, "error": { "$ref": "#/components/schemas/DefaultError" }, "identity": { "description": "The identity ID payload of this patch", "format": "uuid", "type": "string" }, "patch_id": { "description": "The ID of this patch response, if an ID was specified in the patch.", "format": "uuid", "type": "string" } }, "type": "object" }, "identitySchema": { "description": "Raw JSON Schema", "type": "object" }, "identitySchemaContainer": { "description": "An Identity JSON Schema Container", "properties": { "id": { "description": "The ID of the Identity JSON Schema", "type": "string" }, "schema": { "description": "The actual Identity JSON Schema", "type": "object" } }, "required": [ "id", "schema" ], "type": "object" }, "identitySchemaPreset": { "properties": { "schema": { "description": "Schema is the Identity JSON Schema", "type": "object" }, "url": { "description": "URL is the preset identifier", "type": "string" } }, "required": [ "url", "schema" ], "type": "object" }, "identitySchemaPresets": { "items": { "$ref": "#/components/schemas/identitySchemaPreset" }, "type": "array" }, "identitySchemas": { "description": "List of Identity JSON Schemas", "items": { "$ref": "#/components/schemas/identitySchemaContainer" }, "type": "array" }, "identityTraits": { "description": "Traits represent an identity's traits. The identity is able to create, modify, and delete traits\nin a self-service manner. The input will always be validated against the JSON Schema defined\nin `schema_url`." }, "identityVerifiableAddressStatus": { "description": "VerifiableAddressStatus must not exceed 16 characters as that is the limitation in the SQL Schema", "type": "string" }, "identityWithCredentials": { "description": "Create Identity and Import Credentials", "properties": { "lookup_secret": { "$ref": "#/components/schemas/AdminIdentityImportCredentialsLookupSecret" }, "oidc": { "$ref": "#/components/schemas/identityWithCredentialsOidc" }, "passkey": { "$ref": "#/components/schemas/identityWithCredentialsPasskey" }, "password": { "$ref": "#/components/schemas/identityWithCredentialsPassword" }, "saml": { "$ref": "#/components/schemas/identityWithCredentialsSaml" }, "totp": { "$ref": "#/components/schemas/identityWithCredentialsTotp" }, "webauthn": { "$ref": "#/components/schemas/identityWithCredentialsWebAuthn" } }, "type": "object" }, "identityWithCredentialsOidc": { "description": "Create Identity and Import Social Sign In Credentials", "properties": { "config": { "$ref": "#/components/schemas/identityWithCredentialsOidcConfig" } }, "type": "object" }, "identityWithCredentialsOidcConfig": { "properties": { "providers": { "description": "A list of OpenID Connect Providers", "items": { "$ref": "#/components/schemas/identityWithCredentialsOidcConfigProvider" }, "type": "array" } }, "type": "object" }, "identityWithCredentialsOidcConfigProvider": { "description": "Create Identity and Import Social Sign In Credentials Configuration", "properties": { "organization": { "$ref": "#/components/schemas/NullUUID" }, "provider": { "description": "The OpenID Connect provider to link the subject to. Usually something like `google` or `github`.", "type": "string" }, "subject": { "description": "The subject (`sub`) of the OpenID Connect connection. Usually the `sub` field of the ID Token.", "type": "string" }, "use_auto_link": { "description": "If set, this credential allows the user to sign in using the OpenID Connect provider without setting the subject first.", "type": "boolean" } }, "required": [ "subject", "provider" ], "type": "object" }, "identityWithCredentialsPasskey": { "description": "Create Identity and Import Passkey Credentials", "properties": { "config": { "$ref": "#/components/schemas/identityWithCredentialsPasskeyConfig" } }, "type": "object" }, "identityWithCredentialsPasskeyConfig": { "description": "Create Identity and Import Passkey Credentials Configuration", "properties": { "credentials": { "$ref": "#/components/schemas/identityCredentialsWebAuthnList" }, "user_handle": { "description": "UserHandle is the user handle of the webauthn credential.", "items": { "format": "uint8", "type": "integer" }, "type": "array" } }, "type": "object" }, "identityWithCredentialsPassword": { "description": "Create Identity and Import Password Credentials", "properties": { "config": { "$ref": "#/components/schemas/identityWithCredentialsPasswordConfig" } }, "type": "object" }, "identityWithCredentialsPasswordConfig": { "description": "Create Identity and Import Password Credentials Configuration", "properties": { "hashed_password": { "description": "The hashed password in [PHC format](https://www.ory.com/docs/kratos/manage-identities/import-user-accounts-identities#hashed-passwords)", "type": "string" }, "password": { "description": "The password in plain text if no hash is available.", "type": "string" }, "use_password_migration_hook": { "description": "If set to true, the password will be migrated using the password migration hook.", "type": "boolean" } }, "type": "object" }, "identityWithCredentialsSaml": { "description": "Payload to import SAML credentials", "properties": { "config": { "$ref": "#/components/schemas/identityWithCredentialsSamlConfig" } }, "type": "object" }, "identityWithCredentialsSamlConfig": { "description": "Payload of SAML providers", "properties": { "providers": { "description": "A list of SAML Providers", "items": { "$ref": "#/components/schemas/identityWithCredentialsSamlConfigProvider" }, "type": "array" } }, "type": "object" }, "identityWithCredentialsSamlConfigProvider": { "description": "Payload of specific SAML provider", "properties": { "organization": { "$ref": "#/components/schemas/NullUUID" }, "provider": { "description": "The SAML provider to link the subject to.", "type": "string" }, "subject": { "description": "The unique subject of the SAML connection. This value must be immutable at the source.", "type": "string" } }, "required": [ "subject", "provider" ], "type": "object" }, "identityWithCredentialsTotp": { "description": "Create Identity and Import TOTP 2FA Credentials", "properties": { "config": { "$ref": "#/components/schemas/identityWithCredentialsTotpConfig" } }, "type": "object" }, "identityWithCredentialsTotpConfig": { "description": "Create Identity and Import TOTP 2FA Credentials Configuration", "properties": { "totp_url": { "description": "TOTPURL is the TOTP URL\n\nFor more details see: https://github.com/google/google-authenticator/wiki/Key-Uri-Format", "type": "string" } }, "type": "object" }, "identityWithCredentialsWebAuthn": { "description": "Create Identity and Import WebAuthn Credentials", "properties": { "config": { "$ref": "#/components/schemas/identityWithCredentialsWebAuthnConfig" } }, "type": "object" }, "identityWithCredentialsWebAuthnConfig": { "description": "Create Identity and Import WebAuthn Credentials Configuration", "properties": { "credentials": { "$ref": "#/components/schemas/identityCredentialsWebAuthnList" }, "user_handle": { "description": "UserHandle is the user handle of the webauthn credential.", "items": { "format": "uint8", "type": "integer" }, "type": "array" } }, "type": "object" }, "internalGetProjectBrandingBody": { "description": "Get Project Branding Request Body", "properties": { "hostname": { "type": "string" } }, "type": "object" }, "internalIsAXWelcomeScreenEnabledForProjectBody": { "description": "Is Account Experience Enabled For Project Request Body", "properties": { "path": { "description": "Path is the path of the request.", "type": "string" }, "project_slug": { "description": "ProjectSlug is the project's slug.", "type": "string" } }, "required": [ "project_slug", "path" ], "type": "object" }, "internalIsOwnerForProjectBySlug": { "properties": { "project_id": { "description": "ProjectID is the project's ID.", "type": "string" } }, "required": [ "project_id" ], "type": "object" }, "internalIsOwnerForProjectBySlugBody": { "description": "Is Owner For Project By Slug Request Body", "properties": { "namespace": { "description": "Namespace is the namespace of the subject.", "enum": [ "User", " ApiKey" ], "type": "string" }, "organization_id": { "description": "OrganizationID is the organization's ID.", "type": "string" }, "project_scope": { "description": "ProjectScope is the project_id resolved from the\nAPI key.", "type": "string" }, "project_slug": { "description": "ProjectSlug is the project's slug.", "type": "string" }, "subject": { "description": "Subject is the subject acting (user or API key).", "type": "string" } }, "required": [ "subject", "namespace", "project_slug" ], "type": "object" }, "introspectedOAuth2Token": { "description": "Introspection contains an access token's session data as specified by\n[IETF RFC 7662](https://tools.ietf.org/html/rfc7662)", "properties": { "active": { "description": "Active is a boolean indicator of whether or not the presented token\nis currently active. The specifics of a token's \"active\" state\nwill vary depending on the implementation of the authorization\nserver and the information it keeps about its tokens, but a \"true\"\nvalue return for the \"active\" property will generally indicate\nthat a given token has been issued by this authorization server,\nhas not been revoked by the resource owner, and is within its\ngiven time window of validity (e.g., after its issuance time and\nbefore its expiration time).", "type": "boolean" }, "aud": { "description": "Audience contains a list of the token's intended audiences.", "items": { "type": "string" }, "type": "array" }, "client_id": { "description": "ID is a client identifier for the OAuth 2.0 client that\nrequested this token.", "type": "string" }, "exp": { "description": "Expires at is an integer timestamp, measured in the number of seconds\nsince January 1 1970 UTC, indicating when this token will expire.", "format": "int64", "type": "integer" }, "ext": { "additionalProperties": {}, "description": "Extra is arbitrary data set by the session.", "type": "object" }, "iat": { "description": "Issued at is an integer timestamp, measured in the number of seconds\nsince January 1 1970 UTC, indicating when this token was\noriginally issued.", "format": "int64", "type": "integer" }, "iss": { "description": "IssuerURL is a string representing the issuer of this token", "type": "string" }, "nbf": { "description": "NotBefore is an integer timestamp, measured in the number of seconds\nsince January 1 1970 UTC, indicating when this token is not to be\nused before.", "format": "int64", "type": "integer" }, "obfuscated_subject": { "description": "ObfuscatedSubject is set when the subject identifier algorithm was set to \"pairwise\" during authorization.\nIt is the `sub` value of the ID Token that was issued.", "type": "string" }, "scope": { "description": "Scope is a JSON string containing a space-separated list of\nscopes associated with this token.", "type": "string" }, "sub": { "description": "Subject of the token, as defined in JWT [RFC7519].\nUsually a machine-readable identifier of the resource owner who\nauthorized this token.", "type": "string" }, "token_type": { "description": "TokenType is the introspected token's type, typically `Bearer`.", "type": "string" }, "token_use": { "description": "TokenUse is the introspected token's use, for example `access_token` or `refresh_token`.", "type": "string" }, "username": { "description": "Username is a human-readable identifier for the resource owner who\nauthorized this token.", "type": "string" } }, "required": [ "active" ], "type": "object" }, "inviteTokenBody": { "description": "Invite Token Body", "properties": { "invite_token": { "description": "Invite Token\n\nThe Invite Token.\n\nformat: uuid", "format": "uuid", "type": "string" } }, "required": [ "invite_token" ], "type": "object" }, "invoice": { "properties": { "id": { "description": "The ID of the invoice.", "format": "uuid", "readOnly": true, "type": "string" }, "invoiced_at": { "$ref": "#/components/schemas/Time" }, "type": { "description": "Type is the type of the invoice.\nusage InvoiceTypeUsage\nbase InvoiceTypeBase", "enum": [ "usage", "base" ], "readOnly": true, "type": "string", "x-go-enum-desc": "usage InvoiceTypeUsage\nbase InvoiceTypeBase" }, "updated_at": { "format": "date-time", "type": "string" }, "v1": { "$ref": "#/components/schemas/InvoiceDataV1" } }, "required": [ "id", "invoiced_at", "type" ], "type": "object" }, "isOwnerForProjectBySlug": { "properties": { "ProjectSlug": { "description": "ProjectSlug is the project's slug.", "type": "string" }, "Subject": { "description": "Subject is the subject from the API key.", "type": "string" } }, "required": [ "Subject", "ProjectSlug" ], "type": "object" }, "jsonPatch": { "description": "A JSONPatch document as defined by RFC 6902", "properties": { "from": { "description": "This field is used together with operation \"move\" and uses JSON Pointer notation.\n\nLearn more [about JSON Pointers](https://datatracker.ietf.org/doc/html/rfc6901#section-5).", "example": "/name", "type": "string" }, "op": { "description": "The operation to be performed. One of \"add\", \"remove\", \"replace\", \"move\", \"copy\", or \"test\".", "enum": [ "add", "remove", "replace", "move", "copy", "test" ], "example": "replace", "type": "string" }, "path": { "description": "The path to the target path. Uses JSON pointer notation.\n\nLearn more [about JSON Pointers](https://datatracker.ietf.org/doc/html/rfc6901#section-5).", "example": "/name", "type": "string" }, "value": { "description": "The value to be used within the operations.\n\nLearn more [about JSON Pointers](https://datatracker.ietf.org/doc/html/rfc6901#section-5).", "example": "foobar" } }, "required": [ "op", "path" ], "type": "object" }, "jsonPatchDocument": { "description": "A JSONPatchDocument request", "items": { "$ref": "#/components/schemas/jsonPatch" }, "type": "array" }, "jsonWebKey": { "properties": { "alg": { "description": "The \"alg\" (algorithm) parameter identifies the algorithm intended for\nuse with the key. The values used should either be registered in the\nIANA \"JSON Web Signature and Encryption Algorithms\" registry\nestablished by [JWA] or be a value that contains a Collision-\nResistant Name.", "example": "RS256", "type": "string" }, "crv": { "example": "P-256", "type": "string" }, "d": { "example": "T_N8I-6He3M8a7X1vWt6TGIx4xB_GP3Mb4SsZSA4v-orvJzzRiQhLlRR81naWYxfQAYt5isDI6_C2L9bdWo4FFPjGQFvNoRX-_sBJyBI_rl-TBgsZYoUlAj3J92WmY2inbA-PwyJfsaIIDceYBC-eX-xiCu6qMqkZi3MwQAFL6bMdPEM0z4JBcwFT3VdiWAIRUuACWQwrXMq672x7fMuaIaHi7XDGgt1ith23CLfaREmJku9PQcchbt_uEY-hqrFY6ntTtS4paWWQj86xLL94S-Tf6v6xkL918PfLSOTq6XCzxvlFwzBJqApnAhbwqLjpPhgUG04EDRrqrSBc5Y1BLevn6Ip5h1AhessBp3wLkQgz_roeckt-ybvzKTjESMuagnpqLvOT7Y9veIug2MwPJZI2VjczRc1vzMs25XrFQ8DpUy-bNdp89TmvAXwctUMiJdgHloJw23Cv03gIUAkDnsTqZmkpbIf-crpgNKFmQP_EDKoe8p_PXZZgfbRri3NoEVGP7Mk6yEu8LjJhClhZaBNjuWw2-KlBfOA3g79mhfBnkInee5KO9mGR50qPk1V-MorUYNTFMZIm0kFE6eYVWFBwJHLKYhHU34DoiK1VP-svZpC2uAMFNA_UJEwM9CQ2b8qe4-5e9aywMvwcuArRkAB5mBIfOaOJao3mfukKAE", "type": "string" }, "dp": { "example": "G4sPXkc6Ya9y8oJW9_ILj4xuppu0lzi_H7VTkS8xj5SdX3coE0oimYwxIi2emTAue0UOa5dpgFGyBJ4c8tQ2VF402XRugKDTP8akYhFo5tAA77Qe_NmtuYZc3C3m3I24G2GvR5sSDxUyAN2zq8Lfn9EUms6rY3Ob8YeiKkTiBj0", "type": "string" }, "dq": { "example": "s9lAH9fggBsoFR8Oac2R_E2gw282rT2kGOAhvIllETE1efrA6huUUvMfBcMpn8lqeW6vzznYY5SSQF7pMdC_agI3nG8Ibp1BUb0JUiraRNqUfLhcQb_d9GF4Dh7e74WbRsobRonujTYN1xCaP6TO61jvWrX-L18txXw494Q_cgk", "type": "string" }, "e": { "example": "AQAB", "type": "string" }, "k": { "example": "GawgguFyGrWKav7AX4VKUg", "type": "string" }, "kid": { "description": "The \"kid\" (key ID) parameter is used to match a specific key. This\nis used, for instance, to choose among a set of keys within a JWK Set\nduring key rollover. The structure of the \"kid\" value is\nunspecified. When \"kid\" values are used within a JWK Set, different\nkeys within the JWK Set SHOULD use distinct \"kid\" values. (One\nexample in which different keys might use the same \"kid\" value is if\nthey have different \"kty\" (key type) values but are considered to be\nequivalent alternatives by the application using them.) The \"kid\"\nvalue is a case-sensitive string.", "example": "1603dfe0af8f4596", "type": "string" }, "kty": { "description": "The \"kty\" (key type) parameter identifies the cryptographic algorithm\nfamily used with the key, such as \"RSA\" or \"EC\". \"kty\" values should\neither be registered in the IANA \"JSON Web Key Types\" registry\nestablished by [JWA] or be a value that contains a Collision-\nResistant Name. The \"kty\" value is a case-sensitive string.", "example": "RSA", "type": "string" }, "n": { "example": "vTqrxUyQPl_20aqf5kXHwDZrel-KovIp8s7ewJod2EXHl8tWlRB3_Rem34KwBfqlKQGp1nqah-51H4Jzruqe0cFP58hPEIt6WqrvnmJCXxnNuIB53iX_uUUXXHDHBeaPCSRoNJzNysjoJ30TIUsKBiirhBa7f235PXbKiHducLevV6PcKxJ5cY8zO286qJLBWSPm-OIevwqsIsSIH44Qtm9sioFikhkbLwoqwWORGAY0nl6XvVOlhADdLjBSqSAeT1FPuCDCnXwzCDR8N9IFB_IjdStFkC-rVt2K5BYfPd0c3yFp_vHR15eRd0zJ8XQ7woBC8Vnsac6Et1pKS59pX6256DPWu8UDdEOolKAPgcd_g2NpA76cAaF_jcT80j9KrEzw8Tv0nJBGesuCjPNjGs_KzdkWTUXt23Hn9QJsdc1MZuaW0iqXBepHYfYoqNelzVte117t4BwVp0kUM6we0IqyXClaZgOI8S-WDBw2_Ovdm8e5NmhYAblEVoygcX8Y46oH6bKiaCQfKCFDMcRgChme7AoE1yZZYsPbaG_3IjPrC4LBMHQw8rM9dWjJ8ImjicvZ1pAm0dx-KHCP3y5PVKrxBDf1zSOsBRkOSjB8TPODnJMz6-jd5hTtZxpZPwPoIdCanTZ3ZD6uRBpTmDwtpRGm63UQs1m5FWPwb0T2IF0", "type": "string" }, "p": { "example": "6NbkXwDWUhi-eR55Cgbf27FkQDDWIamOaDr0rj1q0f1fFEz1W5A_09YvG09Fiv1AO2-D8Rl8gS1Vkz2i0zCSqnyy8A025XOcRviOMK7nIxE4OH_PEsko8dtIrb3TmE2hUXvCkmzw9EsTF1LQBOGC6iusLTXepIC1x9ukCKFZQvdgtEObQ5kzd9Nhq-cdqmSeMVLoxPLd1blviVT9Vm8-y12CtYpeJHOaIDtVPLlBhJiBoPKWg3vxSm4XxIliNOefqegIlsmTIa3MpS6WWlCK3yHhat0Q-rRxDxdyiVdG_wzJvp0Iw_2wms7pe-PgNPYvUWH9JphWP5K38YqEBiJFXQ", "type": "string" }, "q": { "example": "0A1FmpOWR91_RAWpqreWSavNaZb9nXeKiBo0DQGBz32DbqKqQ8S4aBJmbRhJcctjCLjain-ivut477tAUMmzJwVJDDq2MZFwC9Q-4VYZmFU4HJityQuSzHYe64RjN-E_NQ02TWhG3QGW6roq6c57c99rrUsETwJJiwS8M5p15Miuz53DaOjv-uqqFAFfywN5WkxHbraBcjHtMiQuyQbQqkCFh-oanHkwYNeytsNhTu2mQmwR5DR2roZ2nPiFjC6nsdk-A7E3S3wMzYYFw7jvbWWoYWo9vB40_MY2Y0FYQSqcDzcBIcq_0tnnasf3VW4Fdx6m80RzOb2Fsnln7vKXAQ", "type": "string" }, "qi": { "example": "GyM_p6JrXySiz1toFgKbWV-JdI3jQ4ypu9rbMWx3rQJBfmt0FoYzgUIZEVFEcOqwemRN81zoDAaa-Bk0KWNGDjJHZDdDmFhW3AN7lI-puxk_mHZGJ11rxyR8O55XLSe3SPmRfKwZI6yU24ZxvQKFYItdldUKGzO6Ia6zTKhAVRU", "type": "string" }, "use": { "description": "Use (\"public key use\") identifies the intended use of\nthe public key. The \"use\" parameter is employed to indicate whether\na public key is used for encrypting data or verifying the signature\non data. Values are commonly \"sig\" (signature) or \"enc\" (encryption).", "example": "sig", "type": "string" }, "x": { "example": "f83OJ3D2xF1Bg8vub9tLe1gHMzV76e8Tus9uPHvRVEU", "type": "string" }, "x5c": { "description": "The \"x5c\" (X.509 certificate chain) parameter contains a chain of one\nor more PKIX certificates [RFC5280]. The certificate chain is\nrepresented as a JSON array of certificate value strings. Each\nstring in the array is a base64-encoded (Section 4 of [RFC4648] --\nnot base64url-encoded) DER [ITU.X690.1994] PKIX certificate value.\nThe PKIX certificate containing the key value MUST be the first\ncertificate.", "items": { "type": "string" }, "type": "array" }, "y": { "example": "x_FEzRu9m36HLN_tue659LNpXW6pCyStikYjKIWI5a0", "type": "string" } }, "required": [ "use", "kty", "kid", "alg" ], "type": "object" }, "jsonWebKeySet": { "description": "JSON Web Key Set", "properties": { "keys": { "description": "List of JSON Web Keys\n\nThe value of the \"keys\" parameter is an array of JSON Web Key (JWK)\nvalues. By default, the order of the JWK values within the array does\nnot imply an order of preference among them, although applications\nof JWK Sets can choose to assign a meaning to the order for their\npurposes, if desired.", "items": { "$ref": "#/components/schemas/jsonWebKey" }, "type": "array" } }, "type": "object" }, "keysetPaginationRequestParameters": { "description": "For details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "properties": { "page_size": { "default": 250, "description": "Items per Page\n\nThis is the number of items per page to return.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "format": "int64", "maximum": 1000, "minimum": 1, "type": "integer" }, "page_token": { "description": "Next Page Token\n\nThe next page token.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "type": "string" } }, "title": "Pagination Request Parameters", "type": "object" }, "keysetPaginationResponseHeaders": { "description": "The `Link` HTTP header contains multiple links (`first`, `next`) formatted as:\n`\u003chttps://{project-slug}.projects.oryapis.com/admin/sessions?page_size=250\u0026page_token=\u003e; rel=\"first\"`\n\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "properties": { "link": { "description": "The Link HTTP Header\n\nThe `Link` header contains a comma-delimited list of links to the following pages:\n\nfirst: The first page of results.\nnext: The next page of results.\n\nPages are omitted if they do not exist. For example, if there is no next page, the `next` link is omitted. Examples:\n\n\u003c/admin/sessions?page_size=250\u0026page_token={last_item_uuid}; rel=\"first\",/admin/sessions?page_size=250\u0026page_token=\u003e; rel=\"next\"", "type": "string" } }, "title": "Pagination Response Header", "type": "object" }, "listCustomDomains": { "description": "Custom Hostname List", "items": { "$ref": "#/components/schemas/customDomain" }, "type": "array" }, "listEventStreams": { "description": "Event Stream List", "properties": { "event_streams": { "items": { "$ref": "#/components/schemas/eventStream" }, "type": "array" } }, "type": "object" }, "listInvoicesResponse": { "properties": { "buckets": { "items": { "$ref": "#/components/schemas/BillingPeriodBucket" }, "type": "array" }, "has_next_page": { "type": "boolean" }, "next_page_token": { "type": "string" } }, "required": [ "buckets", "next_page_token", "has_next_page" ], "type": "object" }, "listOrganizationsResponse": { "description": "B2B SSO Organization List", "properties": { "has_next_page": { "type": "boolean" }, "next_page_token": { "type": "string" }, "organizations": { "description": "The list of organizations", "items": { "$ref": "#/components/schemas/organization" }, "type": "array" } }, "required": [ "organizations", "next_page_token", "has_next_page" ], "type": "object" }, "listWorkspaceProjects": { "properties": { "has_next_page": { "type": "boolean" }, "next_page": { "type": "string" }, "projects": { "items": { "$ref": "#/components/schemas/projectMetadata" }, "type": "array" } }, "required": [ "projects", "next_page", "has_next_page" ], "type": "object" }, "listWorkspaces": { "properties": { "has_next_page": { "type": "boolean" }, "next_page_token": { "type": "string" }, "workspaces": { "items": { "$ref": "#/components/schemas/workspace" }, "type": "array" } }, "required": [ "workspaces", "next_page_token", "has_next_page" ], "type": "object" }, "loginFlow": { "description": "This object represents a login flow. A login flow is initiated at the \"Initiate Login API / Browser Flow\"\nendpoint by a client.\n\nOnce a login flow is completed successfully, a session cookie or session token will be issued.", "properties": { "active": { "description": "The active login method\n\nIf set contains the login method used. If the flow is new, it is unset.\npassword CredentialsTypePassword\noidc CredentialsTypeOIDC\ntotp CredentialsTypeTOTP\nlookup_secret CredentialsTypeLookup\nwebauthn CredentialsTypeWebAuthn\ncode CredentialsTypeCodeAuth\npasskey CredentialsTypePasskey\nprofile CredentialsTypeProfile\nsaml CredentialsTypeSAML\ndeviceauthn CredentialsTypeDeviceAuthn\nidentifier_first CredentialsTypeIdentifierFirst\nlink_recovery CredentialsTypeRecoveryLink CredentialsTypeRecoveryLink is a special credential type linked to the link strategy (recovery flow). It is not used within the credentials object itself.\ncode_recovery CredentialsTypeRecoveryCode", "enum": [ "password", "oidc", "totp", "lookup_secret", "webauthn", "code", "passkey", "profile", "saml", "deviceauthn", "identifier_first", "link_recovery", "code_recovery" ], "type": "string", "x-go-enum-desc": "password CredentialsTypePassword\noidc CredentialsTypeOIDC\ntotp CredentialsTypeTOTP\nlookup_secret CredentialsTypeLookup\nwebauthn CredentialsTypeWebAuthn\ncode CredentialsTypeCodeAuth\npasskey CredentialsTypePasskey\nprofile CredentialsTypeProfile\nsaml CredentialsTypeSAML\ndeviceauthn CredentialsTypeDeviceAuthn\nidentifier_first CredentialsTypeIdentifierFirst\nlink_recovery CredentialsTypeRecoveryLink CredentialsTypeRecoveryLink is a special credential type linked to the link strategy (recovery flow). It is not used within the credentials object itself.\ncode_recovery CredentialsTypeRecoveryCode" }, "created_at": { "description": "CreatedAt is a helper struct field for gobuffalo.pop.", "format": "date-time", "type": "string" }, "expires_at": { "description": "ExpiresAt is the time (UTC) when the flow expires. If the user still wishes to log in,\na new flow has to be initiated.", "format": "date-time", "type": "string" }, "id": { "description": "ID represents the flow's unique ID. When performing the login flow, this\nrepresents the id in the login UI's query parameter: http://\u003cselfservice.flows.login.ui_url\u003e/?flow=\u003cflow_id\u003e", "format": "uuid", "type": "string" }, "identity_schema": { "description": "IdentitySchema optionally holds the ID of the identity schema that is used\nfor this flow. This value can be set by the user when creating the flow and\nshould be retained when the flow is saved or converted to another flow.", "type": "string" }, "issued_at": { "description": "IssuedAt is the time (UTC) when the flow started.", "format": "date-time", "type": "string" }, "oauth2_login_challenge": { "description": "Ory OAuth 2.0 Login Challenge.\n\nThis value is set using the `login_challenge` query parameter of the registration and login endpoints.\nIf set will cooperate with Ory OAuth2 and OpenID to act as an OAuth2 server / OpenID Provider.", "type": "string" }, "oauth2_login_request": { "$ref": "#/components/schemas/oAuth2LoginRequest" }, "organization_id": { "$ref": "#/components/schemas/NullUUID" }, "refresh": { "description": "Refresh stores whether this login flow should enforce re-authentication.", "type": "boolean" }, "request_url": { "description": "RequestURL is the initial URL that was requested from Ory Kratos. It can be used\nto forward information contained in the URL's path or query for example.", "type": "string" }, "requested_aal": { "$ref": "#/components/schemas/authenticatorAssuranceLevel" }, "return_to": { "description": "ReturnTo contains the requested return_to URL.", "type": "string" }, "session_token_exchange_code": { "description": "SessionTokenExchangeCode holds the secret code that the client can use to retrieve a session token after the login flow has been completed.\nThis is only set if the client has requested a session token exchange code, and if the flow is of type \"api\",\nand only on creating the login flow.", "type": "string" }, "state": { "description": "State represents the state of this request:\n\nchoose_method: ask the user to choose a method to sign in with\nsent_email: the email has been sent to the user\npassed_challenge: the request was successful and the login challenge was passed." }, "test_context": { "$ref": "#/components/schemas/loginFlowTestContext" }, "transient_payload": { "description": "TransientPayload is used to pass data from the login to hooks and email templates", "type": "object" }, "type": { "$ref": "#/components/schemas/selfServiceFlowType" }, "ui": { "$ref": "#/components/schemas/uiContainer" }, "updated_at": { "description": "UpdatedAt is a helper struct field for gobuffalo.pop.", "format": "date-time", "type": "string" } }, "required": [ "id", "type", "expires_at", "issued_at", "request_url", "ui", "state" ], "title": "Login Flow", "type": "object" }, "loginFlowState": { "description": "The experimental state represents the state of a login flow. This field is EXPERIMENTAL and subject to change!", "enum": [ "choose_method", "sent_email", "passed_challenge" ], "title": "Login flow state (experimental)", "type": "string" }, "loginFlowTestContext": { "description": "Admin-test extension of a login flow. Populated only for flows created by\nthe admin test endpoint; included in the flow's API response so the admin\nUI can render the pre-scoped provider and (once captured) the debug\nround-trip result.", "properties": { "debug_payload": { "$ref": "#/components/schemas/loginFlowTestDebugPayload" }, "provider_id": { "description": "The ID of the OIDC provider this test flow targets.", "type": "string" } }, "required": [ "provider_id" ], "type": "object" }, "loginFlowTestDebugPayload": { "description": "Contains the parsed claims, the Jsonnet mapper input and output, and any\nschema validation errors. Bearer tokens (id_token, access_token,\nrefresh_token) are intentionally excluded to limit the blast radius of\nthe debug payload leaking through audit logs or admin browsers.", "properties": { "error": { "$ref": "#/components/schemas/loginFlowTestStepError" }, "id_token_claims": { "additionalProperties": {}, "description": "Claims extracted from the ID token.", "type": "object" }, "jsonnet_input": { "additionalProperties": {}, "description": "Input JSON that was fed into the Jsonnet mapper.", "type": "object" }, "jsonnet_mapper_url": { "description": "URL of the Jsonnet mapper that was executed on the claims.", "type": "string" }, "jsonnet_output": { "additionalProperties": {}, "description": "Output JSON returned by the Jsonnet mapper.", "type": "object" }, "jsonnet_stderr": { "description": "Anything the Jsonnet mapper wrote to standard error.", "type": "string" }, "schema_validation_errors": { "description": "Identity-schema validation errors produced from the mapped traits.", "items": { "$ref": "#/components/schemas/loginFlowTestSchemaValidationError" }, "type": "array" }, "userinfo": { "additionalProperties": {}, "description": "Claims returned from the provider's userinfo endpoint, if any.", "type": "object" } }, "title": "Diagnostic payload captured during a test-mode OIDC round-trip.", "type": "object" }, "loginFlowTestSchemaValidationError": { "description": "One identity-schema validation failure recorded while evaluating the\ntraits produced by the Jsonnet mapper.", "properties": { "message": { "description": "Human-readable description of the validation failure.", "type": "string" }, "path": { "description": "JSON pointer to the field that failed validation.", "type": "string" } }, "type": "object" }, "loginFlowTestStepError": { "description": "Populated when any step (token exchange, claims decode, Jsonnet\nevaluation, schema validation) cannot complete.", "properties": { "message": { "description": "Human-readable message describing the failure.", "type": "string" }, "reason": { "description": "Short classification of the failure cause (for example,\n\"access_denied\" or \"traits_invalid\").", "type": "string" }, "step": { "description": "Machine-readable identifier of the failed step (for example,\n\"token_exchange\" or \"schema_validate\").", "type": "string" } }, "title": "Classified failure of a step in an OIDC test round-trip.", "type": "object" }, "logoutFlow": { "description": "Logout Flow", "properties": { "logout_token": { "description": "LogoutToken can be used to perform logout using AJAX.", "type": "string" }, "logout_url": { "description": "LogoutURL can be opened in a browser to sign the user out.\n\nformat: uri", "type": "string" } }, "required": [ "logout_url", "logout_token" ], "type": "object" }, "manageSessionsBody": { "description": "Body for the bulk session management endpoint. Exactly one of `identities`\nor `sessions` must be provided. To operate on every session in the network,\npass `identities: [\"*\"]` — the wildcard must appear alone, never mixed with\nexplicit IDs.", "properties": { "action": { "description": "Action to perform on the matching sessions.\ndisable ManageSessionsActionDisable\ndelete ManageSessionsActionDelete", "enum": [ "disable", "delete" ], "type": "string", "x-go-enum-desc": "disable ManageSessionsActionDisable\ndelete ManageSessionsActionDelete" }, "identities": { "description": "Identity IDs whose sessions should be disabled or deleted, or `[\"*\"]`\nto operate on every session in the network. Mutually exclusive with\n`sessions`.", "items": { "type": "string" }, "type": "array" }, "sessions": { "description": "Session IDs to disable or delete. Mutually exclusive with `identities`.\nThe wildcard `[\"*\"]` is not accepted in this field — pass\n`identities: [\"*\"]` to scope the operation to every session in the\nnetwork.", "items": { "type": "string" }, "type": "array" } }, "required": [ "action" ], "title": "Manage Sessions Body", "type": "object" }, "manageSessionsResponse": { "description": "Response body for the bulk session management endpoint. Reports how many\nrows the call processed and, for the wildcard variant, whether the network\nstill has matching rows left. Explicit-IDs requests always return\n`more: false`. Wildcard callers drain the network by re-issuing the same\nrequest while `more` is `true`.", "properties": { "more": { "description": "True when the call reached the per-call batch limit and additional\nmatching rows may remain. Always false for explicit-IDs requests.", "type": "boolean" }, "processed": { "description": "Number of sessions processed in this call. For `disable`, counts only\nsessions that were active before the call (already-inactive sessions\nare skipped). For `delete`, counts every matching row removed.", "format": "int64", "type": "integer" } }, "title": "Manage Sessions Response", "type": "object" }, "managedIdentitySchema": { "description": "Together the name and identity uuid are a unique index constraint.\nThis prevents a user from having schemas with the same name.\nThis also allows schemas to have the same name across the system.", "properties": { "blob_name": { "description": "The gcs file name\n\nThis is a randomly generated name which is used to uniquely identify the file on the blob storage", "type": "string" }, "blob_url": { "description": "The publicly accessible url of the schema", "type": "string" }, "content_hash": { "description": "The Content Hash\n\nContains a hash of the schema's content.", "type": "string" }, "created_at": { "description": "The Schema's Creation Date", "format": "date-time", "readOnly": true, "type": "string" }, "id": { "description": "The schema's ID.", "format": "uuid", "readOnly": true, "type": "string" }, "name": { "description": "The schema name\n\nThis is set by the user and is for them to easily recognise their schema", "example": "CustomerIdentity", "type": "string" }, "updated_at": { "description": "Last Time Schema was Updated", "format": "date-time", "readOnly": true, "type": "string" } }, "required": [ "id", "name", "blob_name", "blob_url", "created_at", "updated_at" ], "title": "Schema represents an Ory Kratos Identity Schema", "type": "object" }, "managedIdentitySchemaValidationResult": { "description": "Ory Identity Schema Validation Result", "properties": { "message": { "type": "string" }, "valid": { "type": "boolean" } }, "type": "object" }, "managedIdentitySchemas": { "items": { "$ref": "#/components/schemas/managedIdentitySchema" }, "type": "array" }, "memberInvite": { "properties": { "created_at": { "description": "The Project's Revision Creation Date", "format": "date-time", "readOnly": true, "type": "string" }, "id": { "description": "The invite's ID.", "format": "uuid", "readOnly": true, "type": "string" }, "invitee_email": { "description": "The invitee's email", "type": "string" }, "invitee_id": { "$ref": "#/components/schemas/NullUUID" }, "owner_email": { "description": "The invite owner's email\nUsually the project's owner email", "type": "string" }, "owner_id": { "description": "The invite owner's ID\nUsually the project's owner", "format": "uuid", "type": "string" }, "project_id": { "$ref": "#/components/schemas/NullUUID" }, "role": { "$ref": "#/components/schemas/String" }, "status": { "description": "The invite's status\nKeeps track of the invites status such as pending, accepted, declined, expired\npending PENDING\naccepted ACCEPTED\ndeclined DECLINED\nexpired EXPIRED\ncancelled CANCELLED\nremoved REMOVED", "enum": [ "pending", "accepted", "declined", "expired", "cancelled", "removed" ], "type": "string", "x-go-enum-desc": "pending PENDING\naccepted ACCEPTED\ndeclined DECLINED\nexpired EXPIRED\ncancelled CANCELLED\nremoved REMOVED" }, "updated_at": { "description": "Last Time Project's Revision was Updated", "format": "date-time", "readOnly": true, "type": "string" }, "workspace_id": { "$ref": "#/components/schemas/NullUUID" } }, "required": [ "id", "owner_id", "owner_email", "invitee_email", "status", "created_at", "updated_at" ], "type": "object" }, "memberInvites": { "items": { "$ref": "#/components/schemas/memberInvite" }, "type": "array" }, "message": { "properties": { "body": { "type": "string" }, "channel": { "type": "string" }, "created_at": { "description": "CreatedAt is a helper struct field for gobuffalo.pop.", "format": "date-time", "type": "string" }, "dispatches": { "description": "Dispatches store information about the attempts of delivering a message\nMay contain an error if any happened, or just the `success` state.", "items": { "$ref": "#/components/schemas/messageDispatch" }, "type": "array" }, "id": { "format": "uuid", "type": "string" }, "recipient": { "type": "string" }, "send_count": { "format": "int64", "type": "integer" }, "status": { "$ref": "#/components/schemas/courierMessageStatus" }, "subject": { "type": "string" }, "template_type": { "description": "\nrecovery_invalid TypeRecoveryInvalid\nrecovery_valid TypeRecoveryValid\nrecovery_code_invalid TypeRecoveryCodeInvalid\nrecovery_code_valid TypeRecoveryCodeValid\nverification_invalid TypeVerificationInvalid\nverification_valid TypeVerificationValid\nverification_code_invalid TypeVerificationCodeInvalid\nverification_code_valid TypeVerificationCodeValid\nstub TypeTestStub\nlogin_code_valid TypeLoginCodeValid\nregistration_code_valid TypeRegistrationCodeValid\nverifiable_address_changed TypeVerifiableAddressChanged\nauthenticator_key_added TypeAuthenticatorKeyAdded", "enum": [ "recovery_invalid", "recovery_valid", "recovery_code_invalid", "recovery_code_valid", "verification_invalid", "verification_valid", "verification_code_invalid", "verification_code_valid", "stub", "login_code_valid", "registration_code_valid", "verifiable_address_changed", "authenticator_key_added" ], "type": "string", "x-go-enum-desc": "recovery_invalid TypeRecoveryInvalid\nrecovery_valid TypeRecoveryValid\nrecovery_code_invalid TypeRecoveryCodeInvalid\nrecovery_code_valid TypeRecoveryCodeValid\nverification_invalid TypeVerificationInvalid\nverification_valid TypeVerificationValid\nverification_code_invalid TypeVerificationCodeInvalid\nverification_code_valid TypeVerificationCodeValid\nstub TypeTestStub\nlogin_code_valid TypeLoginCodeValid\nregistration_code_valid TypeRegistrationCodeValid\nverifiable_address_changed TypeVerifiableAddressChanged\nauthenticator_key_added TypeAuthenticatorKeyAdded" }, "type": { "$ref": "#/components/schemas/courierMessageType" }, "updated_at": { "description": "UpdatedAt is a helper struct field for gobuffalo.pop.", "format": "date-time", "type": "string" } }, "required": [ "id", "status", "type", "recipient", "body", "subject", "template_type", "send_count", "created_at", "updated_at" ], "type": "object" }, "messageDispatch": { "description": "MessageDispatch represents an attempt of sending a courier message\nIt contains the status of the attempt (failed or successful) and the error if any occured", "properties": { "created_at": { "description": "CreatedAt is a helper struct field for gobuffalo.pop.", "format": "date-time", "type": "string" }, "error": { "$ref": "#/components/schemas/JSONRawMessage" }, "id": { "description": "The ID of this message dispatch", "format": "uuid", "type": "string" }, "message_id": { "description": "The ID of the message being dispatched", "format": "uuid", "type": "string" }, "status": { "description": "The status of this dispatch\nEither \"failed\" or \"success\"\nfailed CourierMessageDispatchStatusFailed\nsuccess CourierMessageDispatchStatusSuccess", "enum": [ "failed", "success" ], "type": "string", "x-go-enum-desc": "failed CourierMessageDispatchStatusFailed\nsuccess CourierMessageDispatchStatusSuccess" }, "updated_at": { "description": "UpdatedAt is a helper struct field for gobuffalo.pop.", "format": "date-time", "type": "string" } }, "required": [ "id", "message_id", "status", "created_at", "updated_at" ], "type": "object" }, "metricsDatapoint": { "description": "Represents a single datapoint/bucket of a time series", "properties": { "count": { "description": "The count of events that occured in this time", "format": "int64", "type": "integer" }, "time": { "description": "The time of the bucket", "format": "date-time", "type": "string" } }, "required": [ "time", "count" ], "type": "object" }, "namespace": { "properties": { "name": { "description": "Name of the namespace.", "type": "string" } }, "type": "object" }, "needsPrivilegedSessionError": { "properties": { "error": { "$ref": "#/components/schemas/genericError" }, "redirect_browser_to": { "description": "Points to where to redirect the user to next.", "type": "string" } }, "required": [ "redirect_browser_to" ], "title": "Is sent when a privileged session is required to perform the settings update.", "type": "object" }, "normalizedProject": { "properties": { "created_at": { "description": "The Project's Creation Date", "format": "date-time", "readOnly": true, "type": "string" }, "current_revision": { "$ref": "#/components/schemas/normalizedProjectRevision" }, "environment": { "description": "The environment of the project.\nprod Production\nstage Staging\ndev Development", "enum": [ "prod", "stage", "dev" ], "type": "string", "x-go-enum-desc": "prod Production\nstage Staging\ndev Development" }, "home_region": { "description": "The project's data home region.\neu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global", "enum": [ "eu-central", "asia-northeast", "us-east", "us-west", "eu", "asia", "us", "global" ], "readOnly": true, "type": "string", "x-go-enum-desc": "eu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global" }, "hosts": { "description": "The FQDN hostnames this project listens on", "items": { "type": "string" }, "minItems": 1, "type": "array" }, "id": { "description": "The project's ID.", "format": "uuid", "readOnly": true, "type": "string" }, "slug": { "description": "The project's slug", "readOnly": true, "type": "string" }, "state": { "description": "The state of the project.\nrunning Running\nhalted Halted\ndeleted Deleted", "enum": [ "running", "halted", "deleted" ], "readOnly": true, "type": "string", "x-go-enum-desc": "running Running\nhalted Halted\ndeleted Deleted" }, "subscription_id": { "$ref": "#/components/schemas/NullUUID" }, "subscription_plan": { "$ref": "#/components/schemas/String" }, "updated_at": { "description": "Last Time Project was Updated", "format": "date-time", "readOnly": true, "type": "string" }, "workspace": { "$ref": "#/components/schemas/workspace" }, "workspace_id": { "$ref": "#/components/schemas/NullUUID" } }, "required": [ "id", "hosts", "slug", "current_revision", "state", "environment", "workspace_id", "home_region", "created_at", "updated_at" ], "type": "object" }, "normalizedProjectRevision": { "properties": { "account_experience_contact_url": { "description": "Holds the URL to the account experience's Contact page.\nThis governs the \"contact_url\" setting.", "type": "string" }, "account_experience_custom_translations": { "description": "The Account Experience's Custom Translations\n\nContains all Custom Translations for this project.", "items": { "$ref": "#/components/schemas/RevisionAccountExperienceCustomTranslation" }, "type": "array" }, "account_experience_default_locale": { "description": "Holds the default locale for the account experience.\nThis governs the \"default_locale\" setting.", "type": "string" }, "account_experience_enabled_locales": { "description": "The Account Experience's Enabled Locales\n\nThis governs the locales that are available in the account experience.\nThis governs the \"enabled_locales\" setting.", "items": { "type": "string" }, "type": "array" }, "account_experience_favicon_dark": { "description": "Holds the URL to the account experience's dark theme favicon (currently unused).\nThis governs the \"favicon_dark\" setting.", "type": "string" }, "account_experience_favicon_light": { "description": "Holds the URL to the account experience's favicon.\nThis governs the \"favicon_light\" setting.", "type": "string" }, "account_experience_hide_ory_branding": { "description": "Whether to hide the Ory branding badge on the account experience.\nThis governs the \"hide_ory_branding\" setting.", "type": "boolean" }, "account_experience_hide_registration_link": { "description": "Whether to hide the registration link on the account experience login card.\nThis governs the \"hide_registration_link\" setting.", "type": "boolean" }, "account_experience_locale_behavior": { "description": "Holds the URL to the account experience's language behavior.\n\nCan be one of:\n`respect_accept_language`: Respect the `Accept-Language` header.\n`force_default`: Force the default language.\nThis governs the \"locale_behavior\" setting.", "type": "string" }, "account_experience_logo_dark": { "description": "Holds the URL to the account experience's dark theme logo (currently unused).\nThis governs the \"logo_dark\" setting.", "type": "string" }, "account_experience_logo_light": { "description": "Holds the URL to the account experience's logo.\nThis governs the \"logo_light\" setting.", "type": "string" }, "account_experience_privacy_policy_url": { "description": "Holds the URL to the account experience's Privacy Policy page.\nThis governs the \"privacy_policy_url\" setting.", "type": "string" }, "account_experience_terms_of_service_url": { "description": "Holds the URL to the account experience's Terms of Service page.\nThis governs the \"terms_of_service_url\" setting.", "type": "string" }, "account_experience_theme_variables_dark": { "description": "Holds the URL to the account experience's dark theme variables.\nThis governs the \"theme_variables_dark\" setting.", "type": "string" }, "account_experience_theme_variables_light": { "description": "Holds the URL to the account experience's light theme variables.\nThis governs the \"theme_variables_light\" setting.", "type": "string" }, "created_at": { "description": "The Project's Revision Creation Date", "format": "date-time", "readOnly": true, "type": "string" }, "disable_account_experience_welcome_screen": { "description": "Whether to disable the account experience welcome screen, which is hosted under `/ui/welcome`.\nThis governs the \"disable_welcome_screen\" setting.", "type": "boolean" }, "enable_ax_v2": { "description": "Whether the new account experience is enabled and reachable.\nThis governs the \"enable_ax_v2\" setting.", "type": "boolean" }, "hydra_oauth2_allowed_top_level_claims": { "description": "A list of custom claims which are allowed to be added top level to the Access Token. They cannot override reserved claims.\n\nThis governs the \"oauth2.allowed_top_level_claims\" setting.", "items": { "type": "string" }, "type": "array" }, "hydra_oauth2_client_credentials_default_grant_allowed_scope": { "description": "Automatically grant authorized OAuth2 Scope in OAuth2 Client Credentials Flow.\n\nEach OAuth2 Client is allowed to request a predefined OAuth2 Scope (for example `read write`). If this option is enabled, the full\nscope is automatically granted when performing the OAuth2 Client Credentials flow.\n\nIf disabled, the OAuth2 Client has to request the scope in the OAuth2 request by providing the `scope` query parameter.\n\nSetting this option to true is common if you need compatibility with MITREid.\n\nThis governs the \"oauth2.client_credentials.default_grant_allowed_scope\" setting.", "type": "boolean" }, "hydra_oauth2_device_authorization_token_polling_interval": { "description": "Configures how often a non-interactive device should poll the\nOAuth 2.0 Device Authorization Grant token endpoint. Purely\ninformational — the value is reported to the device in the\n\"interval\" response field of the device authorization response.\nHydra defaults to 5s when this is left empty.\n\nThis is an Enterprise feature.\n\nThis governs the \"oauth2.device_authorization.token_polling_interval\" setting.", "example": "15s", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "hydra_oauth2_device_authorization_user_code_entropy_preset": { "description": "Picks a preset for the OAuth 2.0 Device Authorization Grant\nuser_code length and character set. \"high\" produces the longest\ncodes (most resistant to brute force); \"low\" the shortest (easiest\nfor the end user to read and enter). Leave empty to keep Hydra's\ndefault preset.\n\nThis is an Enterprise feature.\n\nThis governs the \"oauth2.device_authorization.user_code.entropy_preset\" setting.", "enum": [ "high", "medium", "low" ], "type": "string" }, "hydra_oauth2_exclude_not_before_claim": { "description": "Set to true if you want to omit the `nbf` (not valid before) claim in the access token.\n\nThis governs the \"oauth2.exclude_not_before_claim\" setting.", "type": "boolean" }, "hydra_oauth2_grant_jwt_iat_optional": { "description": "Configures if the issued at (`iat`) claim is required in the JSON Web Token (JWT) Profile for OAuth 2.0 Client Authentication and Authorization Grants (RFC7523).\n\nIf set to `false`, the `iat` claim is required. Set this value to `true` only after careful consideration.\n\nThis governs the \"oauth2.grant.jwt.iat_optional\" setting.", "type": "boolean" }, "hydra_oauth2_grant_jwt_jti_optional": { "description": "Configures if the JSON Web Token ID (`jti`) claim is required in the JSON Web Token (JWT) Profile for OAuth 2.0 Client Authentication and Authorization Grants (RFC7523).\n\nIf set to `false`, the `jti` claim is required. Set this value to `true` only after careful consideration.\n\nThis governs the \"oauth2.grant.jwt.jti_optional\" setting.", "type": "boolean" }, "hydra_oauth2_grant_jwt_max_ttl": { "default": "720h", "description": "Configures what the maximum age of a JWT assertion used in the JSON Web Token (JWT) Profile for OAuth 2.0 Client Authentication and Authorization Grants (RFC7523) can be.\n\nThis feature uses the `exp` claim and `iat` claim to calculate assertion age. Assertions exceeding the max age will be denied.\n\nUseful as a safety measure and recommended to keep below 720h.\n\nThis governs the \"oauth2.grant.jwt.max_ttl\" setting.", "example": "30m", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "hydra_oauth2_grant_jwt_omit_assertion_audience": { "description": "Configures whether the audience (`aud`) claim from the assertion JSON Web Token (JWT) in the JWT Profile for OAuth 2.0 Client Authentication and Authorization Grants (RFC7523) is omitted from the resulting access token.\n\nWhen set to `true` (the default for new projects), the audience values from the inbound assertion JWT are not granted in the access token. Set to `false` to copy the assertion audience into the access token (the legacy behavior).\n\nThis governs the \"oauth2.grant.jwt.omit_assertion_audience\" setting.", "type": "boolean" }, "hydra_oauth2_grant_refresh_token_rotation_grace_period": { "description": "Configures the OAuth2 Grant Refresh Token Rotation Grace Period\n\nIf set to `null` or `\"0s\"`, the graceful refresh token rotation is disabled.\n\nThis governs the \"oauth2.grant.refresh_token.rotation_grace_period\" setting.", "type": "string" }, "hydra_oauth2_grant_refresh_token_rotation_grace_reuse_count": { "description": "Configures the OAuth2 Grant Refresh Token Rotation Grace Reuse Count.\n\nThe maximum number of times a refresh token can be reused within the grace period.\nIf set to `null` or `0`, the limit is disabled.\n\nThis governs the \"oauth2.grant.refresh_token.rotation_grace_reuse_count\" setting.", "format": "int64", "type": "integer" }, "hydra_oauth2_mirror_top_level_claims": { "description": "Set to false if you don't want to mirror custom claims under 'ext'.\n\nThis governs the \"oauth2.mirror_top_level_claims\" setting.", "type": "boolean" }, "hydra_oauth2_pkce_enforced": { "description": "Configures whether PKCE should be enforced for all OAuth2 Clients.\n\nThis governs the \"oauth2.pkce.enforced\" setting.", "type": "boolean" }, "hydra_oauth2_pkce_enforced_for_public_clients": { "description": "Configures whether PKCE should be enforced for OAuth2 Clients without a client secret (public clients).\n\nThis governs the \"oauth2.pkce.enforced_for_public_clients\" setting.", "type": "boolean" }, "hydra_oauth2_preserve_ext_claims": { "description": "Set to true to keep custom claims that are not promoted to the top level in the 'ext' claim. Only applies when mirror_top_level_claims is false.\n\nThis governs the \"oauth2.preserve_ext_claims\" setting.", "type": "boolean" }, "hydra_oauth2_refresh_token_hook": { "description": "Sets the Refresh Token Hook Endpoint. If set this endpoint will be called during the OAuth2 Token Refresh grant update the OAuth2 Access Token claims.\n\nThis governs the \"oauth2.refresh_token_hook\" setting.", "type": "string" }, "hydra_oauth2_token_hook": { "description": "Sets the token hook endpoint for all grant types. If set it will be called while providing token to customize claims.\n\nThis governs the \"oauth2.token_hook.url\" setting.", "type": "string" }, "hydra_oauth2_token_prefix": { "description": "Sets a per-project Access Token, Refresh Token, and Authorization Code\nprefix. The literal \"%s\" is replaced at issuance time with the token kind:\n\"at\" (access token), \"rt\" (refresh token), or \"ac\" (authorization code).\nFor example, \"acme_%s_\" yields \"acme_at_…\", \"acme_rt_…\", and \"acme_ac_…\".\n\nMust be a fmt.Sprintf template with exactly one \"%s\" substitution. The\nrendered prefix may contain only ASCII letters, digits, and underscores —\nno other \"%\" directives (\"%d\", \"%%\", positional or width-flagged verbs),\nno hyphens, dots, slashes, whitespace, quotes, or non-ASCII characters.\nLeave empty to keep the default \"ory_%s_\" prefix.\n\nThis is an Enterprise feature.\n\nThis governs the \"oauth2.token_prefix\" setting.", "type": "string" }, "hydra_oidc_dynamic_client_registration_default_scope": { "description": "The OpenID Connect Dynamic Client Registration specification has no concept of whitelisting OAuth 2.0 Scope. If you want to expose Dynamic Client Registration, you should set the default scope enabled for newly registered clients. Keep in mind that users can overwrite this default by setting the \"scope\" key in the registration payload, effectively disabling the concept of whitelisted scopes.\n\nThis governs the \"oidc.dynamic_client_registration.default_scope\" setting.", "items": { "type": "string" }, "type": "array" }, "hydra_oidc_dynamic_client_registration_enabled": { "description": "Configures OpenID Connect Dynamic Client Registration.\n\nThis governs the \"oidc.dynamic_client_registration.enabled\" setting.", "type": "boolean" }, "hydra_oidc_subject_identifiers_pairwise_salt": { "description": "Configures OpenID Connect Discovery and overwrites the pairwise algorithm\n\nThis governs the \"oidc.subject_identifiers.pairwise_salt\" setting.", "type": "string" }, "hydra_oidc_subject_identifiers_supported_types": { "description": "Configures OpenID Connect Discovery and overwrites the list of Subject Identifier Algorithms to enable.\n\nThis governs the \"oidc.subject_identifiers.supported_types\" setting.", "items": { "type": "string" }, "type": "array" }, "hydra_secrets_cookie": { "description": "Configures the Ory Hydra Cookie Secret\n\nThis governs the \"secrets.cookie\" setting.", "items": { "type": "string" }, "type": "array" }, "hydra_secrets_pagination": { "description": "Configures the Ory Hydra Pagination Secret\n\nThis governs the \"secrets.pagination\" setting.", "items": { "type": "string" }, "type": "array" }, "hydra_secrets_system": { "description": "Configures the Ory Hydra System Secret\n\nThis governs the \"secrets.system\" setting.", "items": { "type": "string" }, "type": "array" }, "hydra_serve_cookies_same_site_legacy_workaround": { "description": "Configures the Ory Hydra Cookie Same Site Legacy Workaround\n\nThis governs the \"serve.cookies.same_site_legacy_workaround\" setting.", "type": "boolean" }, "hydra_serve_cookies_same_site_mode": { "description": "Configures the Ory Hydra Cookie Same Site Mode\n\nThis governs the \"serve.cookies.same_site_mode\" setting.", "type": "string" }, "hydra_strategies_access_token": { "default": "opaque", "description": "Defines access token type\n\nThis governs the \"strategies.access_token\" setting.\nopaque Oauth2AccessTokenStrategyOpaque\njwt Oauth2AccessTokenStrategyJwt", "enum": [ "opaque", "jwt" ], "type": "string", "x-go-enum-desc": "opaque Oauth2AccessTokenStrategyOpaque\njwt Oauth2AccessTokenStrategyJwt" }, "hydra_strategies_jwt_scope_claim": { "default": "list", "description": "Define the claim to use as the scope in the access token.\n\nThis governs the \"strategies.jwt.scope_claim\" setting.\n\nlist: The scope claim is an array of strings named `scope`: `{ \"scope\": [\"read\", \"write\"] }`\nstring: The scope claim is a space delimited list of strings named `scp`: `{ \"scp\": \"read write\" }`\nboth: The scope claim is both a space delimited list and an array of strings named `scope` and `scp`: `{ \"scope\": [\"read\", \"write\"], \"scp\": \"read write\" }`\nlist OAuth2JWTScopeClaimList\nstring OAuth2JWTScopeClaimString\nboth OAuth2JWTScopeClaimBoth", "enum": [ "list", "string", "both" ], "type": "string", "x-go-enum-desc": "list OAuth2JWTScopeClaimList\nstring OAuth2JWTScopeClaimString\nboth OAuth2JWTScopeClaimBoth" }, "hydra_strategies_scope": { "default": "wildcard", "description": "Defines how scopes are matched. For more details have a look at https://github.com/ory/fosite#scopes\n\nThis governs the \"strategies.scope\" setting.\nexact Oauth2ScopeStrategyExact\nwildcard Oauth2ScopeStrategyWildcard", "enum": [ "exact", "wildcard" ], "type": "string", "x-go-enum-desc": "exact Oauth2ScopeStrategyExact\nwildcard Oauth2ScopeStrategyWildcard" }, "hydra_ttl_access_token": { "default": "30m", "description": "This governs the \"ttl.access_token\" setting.", "example": "1h", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "hydra_ttl_auth_code": { "default": "720h", "description": "Configures how long refresh tokens are valid.\n\nSet to -1 for refresh tokens to never expire. This is not recommended!\n\nThis governs the \"ttl.auth_code\" setting.", "example": "30m", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "hydra_ttl_device_user_code": { "description": "Configures how long the device_code and user_code in the OAuth 2.0\nDevice Authorization Grant remain valid. Larger values mean more\ndatabase storage; shorter values mean users have less time to\ncomplete the second-device verification. Hydra defaults to 10m\nwhen this is left empty.\n\nThis is an Enterprise feature.\n\nThis governs the \"ttl.device_user_code\" setting.", "example": "30m", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "hydra_ttl_id_token": { "default": "30m", "description": "This governs the \"ttl.id_token\" setting.", "example": "1h", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "hydra_ttl_login_consent_request": { "default": "30m", "description": "Configures how long a user login and consent flow may take.\n\nThis governs the \"ttl.login_consent_request\" setting.", "example": "1h", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "hydra_ttl_refresh_token": { "default": "720h", "description": "Configures how long refresh tokens are valid.\n\nSet to -1 for refresh tokens to never expire. This is not recommended!\n\nThis governs the \"ttl.refresh_token\" setting.", "example": "30m", "pattern": "^(([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+|-1)$", "type": "string" }, "hydra_urls_consent": { "description": "Sets the OAuth2 Consent Endpoint URL of the OAuth2 User Login \u0026 Consent flow.\n\nDefaults to the Ory Account Experience if left empty.\n\nThis governs the \"urls.consent\" setting.", "type": "string" }, "hydra_urls_device_success": { "description": "Sets the URL the user is redirected to after successfully completing\nthe OAuth 2.0 Device Authorization Grant user verification step.\nDefaults to the Ory Account Experience fallback page if left empty.\n\nThis is an Enterprise feature.\n\nThis governs the \"urls.device.success\" setting.", "type": "string" }, "hydra_urls_device_verification": { "description": "Sets the URL of the user verification page for the OAuth 2.0 Device\nAuthorization Grant (RFC 8628). End users are redirected to this URL\nto enter the user_code shown on their device. Defaults to the Ory\nAccount Experience fallback page if left empty.\n\nThis is an Enterprise feature.\n\nThis governs the \"urls.device.verification\" setting.", "type": "string" }, "hydra_urls_error": { "description": "Sets the OAuth2 Error URL of the OAuth2 User Login \u0026 Consent flow.\n\nDefaults to the Ory Account Experience if left empty.\n\nThis governs the \"urls.error\" setting.", "type": "string" }, "hydra_urls_login": { "description": "Sets the OAuth2 Login Endpoint URL of the OAuth2 User Login \u0026 Consent flow.\n\nDefaults to the Ory Account Experience if left empty.\n\nThis governs the \"urls.login\" setting.", "type": "string" }, "hydra_urls_logout": { "description": "Sets the logout endpoint.\n\nDefaults to the Ory Account Experience if left empty.\n\nThis governs the \"urls.logout\" setting.", "type": "string" }, "hydra_urls_post_logout_redirect": { "description": "When an OAuth2-related user agent requests to log out, they will be redirected to this url afterwards per default.\n\nDefaults to the Ory Account Experience in development and your application in production mode when a custom domain is connected.\n\nThis governs the \"urls.post_logout_redirect\" setting.", "type": "string" }, "hydra_urls_registration": { "description": "Sets the OAuth2 Registration Endpoint URL of the OAuth2 User Login \u0026 Consent flow.\n\nDefaults to the Ory Account Experience if left empty.\n\nThis governs the \"urls.registration\" setting.", "type": "string" }, "hydra_urls_self_issuer": { "description": "This value will be used as the issuer in access and ID tokens. It must be specified and using HTTPS protocol, unless the development mode is enabled.\n\nOn the Ory Network it will be very rare that you want to modify this value. If left empty, it will default to the correct value for the Ory Network.\n\nThis governs the \"urls.self.issuer\" setting.", "type": "string" }, "hydra_webfinger_jwks_broadcast_keys": { "description": "A list of JSON Web Keys that should be exposed at that endpoint. This is usually the public key for verifying OpenID Connect ID Tokens. However, you might want to add additional keys here as well.\n\nThis governs the \"webfinger.jwks.broadcast_keys\" setting.", "items": { "type": "string" }, "type": "array" }, "hydra_webfinger_oidc_discovery_auth_url": { "description": "Configures OpenID Connect Discovery and overwrites the OAuth2 Authorization URL.\n\nThis governs the \"webfinger.oidc_discovery.auth_url\" setting.", "type": "string" }, "hydra_webfinger_oidc_discovery_client_registration_url": { "description": "Configures OpenID Connect Discovery and overwrites the OpenID Connect Dynamic Client Registration Endpoint.\n\nThis governs the \"webfinger.oidc_discovery.client_registration_url\" setting.", "type": "string" }, "hydra_webfinger_oidc_discovery_device_authorization_url": { "description": "Override the OAuth 2.0 Device Authorization Endpoint URL that is\nadvertised in the OpenID Connect discovery document\n(/.well-known/openid-configuration). Defaults to the project's\npublic base URL + /oauth2/device/auth.\n\nThis is an Enterprise feature.\n\nThis governs the \"webfinger.oidc_discovery.device_authorization_url\" setting.", "type": "string" }, "hydra_webfinger_oidc_discovery_jwks_url": { "description": "Configures OpenID Connect Discovery and overwrites the JWKS URL.\n\nThis governs the \"webfinger.oidc_discovery.jwks_url\" setting.", "type": "string" }, "hydra_webfinger_oidc_discovery_supported_claims": { "description": "Configures OpenID Connect Discovery and overwrites a list of supported claims to be broadcasted. Claim \"sub\" is always included.\n\nThis governs the \"webfinger.oidc_discovery.supported_claims\" setting.", "items": { "type": "string" }, "type": "array" }, "hydra_webfinger_oidc_discovery_supported_scope": { "description": "Configures OpenID Connect Discovery and overwrites the scope OAuth 2.0 Clients may request. Scope `offline`, `offline_access`, and `openid` are always included.\n\nThis governs the \"webfinger.oidc_discovery.supported_scope\" setting.", "items": { "type": "string" }, "type": "array" }, "hydra_webfinger_oidc_discovery_token_url": { "description": "Configures OpenID Connect Discovery and overwrites the OAuth2 Token URL.\n\nThis governs the \"webfinger.oidc_discovery.token_url\" setting.", "type": "string" }, "hydra_webfinger_oidc_discovery_userinfo_url": { "description": "Configures OpenID Connect Discovery and overwrites userinfo endpoint to be advertised at the OpenID Connect Discovery endpoint /.well-known/openid-configuration. Defaults to Ory Hydra's userinfo endpoint at /userinfo. Set this value if you want to handle this endpoint yourself.\n\nThis governs the \"webfinger.oidc_discovery.userinfo_url\" setting.", "type": "string" }, "id": { "description": "The revision ID.", "format": "uuid", "readOnly": true, "type": "string" }, "keto_namespace_configuration": { "description": "The Revisions' Keto Namespace Configuration\n\nThe string is a URL pointing to an OPL file with the configuration.\n\nThis governs the \"namespaces.location\" setting.", "type": "string" }, "keto_namespaces": { "$ref": "#/components/schemas/KetoNamespaces" }, "keto_secrets_pagination": { "description": "Configures Keto's pagination secrets.\n\nThis governs the \"secrets.pagination\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_cookies_same_site": { "description": "Configures the Ory Kratos Cookie SameSite Attribute\n\nThis governs the \"cookies.same_site\" setting.", "type": "string" }, "kratos_courier_channels": { "$ref": "#/components/schemas/revisionCourierChannels" }, "kratos_courier_delivery_strategy": { "default": "smtp", "description": "The delivery strategy to use when sending emails\n\nThis governs the \"courier.delivery_strategy\" setting.\n\n`smtp`: Use SMTP server\n`http`: Use the built in HTTP client to send the email to some remote service", "type": "string" }, "kratos_courier_http_request_config_auth_api_key_in": { "description": "The location of the API key to use in the HTTP email sending service's authentication\n\n`header`: Send the key value pair as a header\n`cookie`: Send the key value pair as a cookie\nThis governs the \"courier.http.request_config.auth.config.in\" setting.", "type": "string" }, "kratos_courier_http_request_config_auth_api_key_name": { "description": "The name of the API key to use in the HTTP email sending service's authentication\n\nThis governs the \"courier.http.request_config.auth.config.name\" setting.", "type": "string" }, "kratos_courier_http_request_config_auth_api_key_value": { "description": "The value of the API key to use in the HTTP email sending service's authentication\n\nThis governs the \"courier.http.request_config.auth.config.value\" setting.", "type": "string" }, "kratos_courier_http_request_config_auth_basic_auth_password": { "description": "The password to use for basic auth in the HTTP email sending service's authentication\n\nThis governs the \"courier.http.request_config.auth.config.password\" setting.", "type": "string" }, "kratos_courier_http_request_config_auth_basic_auth_user": { "description": "The user to use for basic auth in the HTTP email sending service's authentication\n\nThis governs the \"courier.http.request_config.auth.config.user\" setting.", "type": "string" }, "kratos_courier_http_request_config_auth_type": { "default": "empty (no authentication)", "description": "The authentication type to use while contacting the remote HTTP email sending service\n\nThis governs the \"courier.http.request_config.auth.type\" setting.\n\n`basic_auth`: Use Basic Authentication\n`api_key`: Use API Key Authentication in a header or cookie", "type": "string" }, "kratos_courier_http_request_config_body": { "description": "The Jsonnet template to generate the body to send to the remote HTTP email sending service\n\nShould be valid Jsonnet and base64 encoded\n\nThis governs the \"courier.http.request_config.body\" setting.", "type": "string" }, "kratos_courier_http_request_config_headers": { "description": "Any additional headers to send to the remote HTTP email sending service\n\nThis governs the \"courier.http.request_config.headers\" setting.", "type": "object" }, "kratos_courier_http_request_config_method": { "default": "POST", "description": "The http METHOD to use when calling the remote HTTP email sending service\n\nThis governs the \"courier.http.request_config.method\" setting.", "type": "string" }, "kratos_courier_http_request_config_url": { "description": "The URL of the remote HTTP email sending service\n\nThis governs the \"courier.http.request_config.url\" setting.", "type": "string" }, "kratos_courier_smtp_connection_uri": { "description": "Configures the Ory Kratos SMTP Connection URI\n\nThis governs the \"courier.smtp.connection_uri\" setting.", "type": "string" }, "kratos_courier_smtp_from_address": { "description": "Configures the Ory Kratos SMTP From Address\n\nThis governs the \"courier.smtp.from_address\" setting.", "type": "string" }, "kratos_courier_smtp_from_name": { "description": "Configures the Ory Kratos SMTP From Name\n\nThis governs the \"courier.smtp.from_name\" setting.", "type": "string" }, "kratos_courier_smtp_headers": { "description": "Configures the Ory Kratos SMTP Connection Headers\n\nThis governs the \"courier.smtp.headers\" setting.", "type": "object" }, "kratos_courier_smtp_local_name": { "description": "Configures the local_name to use in SMTP connections\n\nThis governs the \"courier.smtp.local_name\" setting.", "type": "string" }, "kratos_courier_templates_login_code_valid_email_body_html": { "description": "Configures the Ory Kratos Valid Login via Code Email Body HTML Template\n\nThis governs the \"courier.templates.login_code.valid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_login_code_valid_email_body_plaintext": { "description": "Configures the Ory Kratos Valid Login via Code Email Body Plaintext Template\n\nThis governs the \"courier.templates.login_code.valid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_login_code_valid_email_subject": { "description": "Configures the Ory Kratos Valid Login via Code Email Subject Template\n\nThis governs the \"courier.templates.login_code.valid.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_login_code_valid_sms_body_plaintext": { "description": "Configures the Ory Kratos Valid Login via Code SMS plain text body\n\nThis governs the \"courier.templates.login_code.valid.sms.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_recovery_code_invalid_email_body_html": { "description": "Configures the Ory Kratos Invalid Recovery via Code Email Body HTML Template\n\nThis governs the \"courier.templates.recovery_code.invalid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_recovery_code_invalid_email_body_plaintext": { "description": "Configures the Ory Kratos Invalid Recovery via Code Email Body Plaintext Template\n\nThis governs the \"courier.templates.recovery_code.invalid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_recovery_code_invalid_email_subject": { "description": "Configures the Ory Kratos Invalid Recovery via Code Email Subject Template\n\nThis governs the \"courier.templates.recovery_code.invalid.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_recovery_code_valid_email_body_html": { "description": "Configures the Ory Kratos Valid Recovery via Code Email Body HTML Template\n\nThis governs the \"courier.templates.recovery_code.valid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_recovery_code_valid_email_body_plaintext": { "description": "Configures the Ory Kratos Valid Recovery via Code Email Body Plaintext Template\n\nThis governs the \"courier.templates.recovery_code.valid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_recovery_code_valid_email_subject": { "description": "Configures the Ory Kratos Valid Recovery via Code Email Subject Template\n\nThis governs the \"courier.templates.recovery_code.valid.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_recovery_invalid_email_body_html": { "description": "Configures the Ory Kratos Invalid Recovery Email Body HTML Template\n\nThis governs the \"courier.templates.recovery.invalid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_recovery_invalid_email_body_plaintext": { "description": "Configures the Ory Kratos Invalid Recovery Email Body Plaintext Template\n\nThis governs the \"courier.templates.recovery.invalid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_recovery_invalid_email_subject": { "description": "Configures the Ory Kratos Invalid Recovery Email Subject Template\n\nThis governs the \"courier.templates.recovery.invalid.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_recovery_valid_email_body_html": { "description": "Configures the Ory Kratos Valid Recovery Email Body HTML Template\n\nThis governs the \"courier.templates.recovery.valid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_recovery_valid_email_body_plaintext": { "description": "Configures the Ory Kratos Valid Recovery Email Body Plaintext Template\n\nThis governs the \"courier.templates.recovery.valid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_recovery_valid_email_subject": { "description": "Configures the Ory Kratos Valid Recovery Email Subject Template\n\nThis governs the \"courier.templates.recovery.valid.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_registration_code_valid_email_body_html": { "description": "Configures the Ory Kratos Valid Registration via Code Email Body HTML Template\n\nThis governs the \"courier.templates.registration_code.valid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_registration_code_valid_email_body_plaintext": { "description": "Configures the Ory Kratos Valid Registration via Code Email Body Plaintext Template\n\nThis governs the \"courier.templates.registration_code.valid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_registration_code_valid_email_subject": { "description": "Configures the Ory Kratos Valid Registration via Code Email Subject Template\n\nThis governs the \"courier.templates.registration_code.valid.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_registration_code_valid_sms_body_plaintext": { "description": "Configures the Ory Kratos Valid Registration via Code SMS Body Plaintext Template\n\nThis governs the \"courier.templates.registration_code.valid.sms.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_verifiable_address_changed_email_body_html": { "description": "Configures the Ory Kratos Verifiable Address Changed Email Body HTML Template\n\nThis governs the \"courier.templates.verifiable_address_changed.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_verifiable_address_changed_email_body_plaintext": { "description": "Configures the Ory Kratos Verifiable Address Changed Email Body Plaintext Template\n\nThis governs the \"courier.templates.verifiable_address_changed.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_verifiable_address_changed_email_subject": { "description": "Configures the Ory Kratos Verifiable Address Changed Email Subject Template\n\nThis governs the \"courier.templates.verifiable_address_changed.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_verifiable_address_changed_sms_body_plaintext": { "description": "Configures the Ory Kratos Verifiable Address Changed SMS Body Plaintext Template\n\nThis governs the \"courier.templates.verifiable_address_changed.sms.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_verification_code_invalid_email_body_html": { "description": "Configures the Ory Kratos Invalid Verification via Code Email Body HTML Template\n\nThis governs the \"courier.templates.verification_code.invalid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_verification_code_invalid_email_body_plaintext": { "description": "Configures the Ory Kratos Invalid Verification via Code Email Body Plaintext Template\n\nThis governs the \"courier.templates.verification_code.invalid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_verification_code_invalid_email_subject": { "description": "Configures the Ory Kratos Invalid Verification via Code Email Subject Template\n\nThis governs the \"courier.templates.verification_code.invalid.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_verification_code_valid_email_body_html": { "description": "Configures the Ory Kratos Valid Verification via Code Email Body HTML Template\n\nThis governs the \"courier.templates.verification_code.valid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_verification_code_valid_email_body_plaintext": { "description": "Configures the Ory Kratos Valid Verification via Code Email Body Plaintext Template\n\nThis governs the \"courier.templates.verification_code.valid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_verification_code_valid_email_subject": { "description": "Configures the Ory Kratos Valid Verification via Code Email Subject Template\n\nThis governs the \"courier.templates.verification_code.valid.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_verification_code_valid_sms_body_plaintext": { "description": "Configures the Ory Kratos Valid Verification via Code SMS Body Plaintext\n\nThis governs the \"courier.templates.verification_code.valid.sms.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_verification_invalid_email_body_html": { "description": "Configures the Ory Kratos Invalid Verification Email Body HTML Template\n\nThis governs the \"courier.templates.verification.invalid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_verification_invalid_email_body_plaintext": { "description": "Configures the Ory Kratos Invalid Verification Email Body Plaintext Template\n\nThis governs the \"courier.templates.verification.invalid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_verification_invalid_email_subject": { "description": "Configures the Ory Kratos Invalid Verification Email Subject Template\n\nThis governs the \"courier.templates.verification.invalid.email.subject\" setting.", "type": "string" }, "kratos_courier_templates_verification_valid_email_body_html": { "description": "Configures the Ory Kratos Valid Verification Email Body HTML Template\n\nThis governs the \"courier.templates.verification.valid.email.body.html\" setting.", "type": "string" }, "kratos_courier_templates_verification_valid_email_body_plaintext": { "description": "Configures the Ory Kratos Valid Verification Email Body Plaintext Template\n\nThis governs the \"courier.templates.verification.valid.email.body.plaintext\" setting.", "type": "string" }, "kratos_courier_templates_verification_valid_email_subject": { "description": "Configures the Ory Kratos Valid Verification Email Subject Template\n\nThis governs the \"courier.templates.verification.valid.email.subject\" setting.", "type": "string" }, "kratos_feature_flags_cacheable_sessions": { "description": "Configures the Ory Kratos Session caching feature flag\n\nThis governs the \"feature_flags.cacheable_sessions\" setting.", "type": "boolean" }, "kratos_feature_flags_cacheable_sessions_max_age": { "description": "Configures the Ory Kratos Session caching max-age feature flag\n\nThis governs the \"feature_flags.cacheable_sessions_max_age\" setting.", "type": "string" }, "kratos_feature_flags_choose_recovery_address": { "description": "This governs the \"feature_flags.choose_recovery_address\" setting.", "type": "boolean" }, "kratos_feature_flags_faster_session_extend": { "description": "Configures the Ory Kratos Faster Session Extend setting\n\nIf enabled allows faster session extension by skipping the session lookup and returning 201 instead of 200.\nDisabling this feature will be deprecated in the future.\n\nThis governs the \"feature_flags.faster_session_extend\" setting.", "type": "boolean" }, "kratos_feature_flags_legacy_continue_with_verification_ui": { "description": "Always include show_verification_ui in continue_with\n\nIf true, restores the legacy behavior of always including `show_verification_ui` in the registration flow's `continue_with` when verification is enabled. If set to false, `show_verification_ui` is only set in `continue_with` if the `show_verification_ui` hook is used. This flag will be removed in the future.\n\nThis governs the \"feature_flags.legacy_continue_with_verification_ui\" setting.", "type": "boolean" }, "kratos_feature_flags_legacy_oidc_registration_node_group": { "description": "Controls whether the UI nodes in an OIDC registration flow have group \"oidc\" in case required fields are not returned by the OIDC provider.\n\nIf set to true, the UI nodes will have group \"oidc\" and the flow will be considered successful if the user completes the flow. This is the legacy behavior.\n\nThis governs the \"feature_flags.legacy_oidc_registration_node_group\" setting.", "type": "boolean" }, "kratos_feature_flags_legacy_require_verified_login_error": { "description": "Return a form error if the login identifier is not verified\n\nIf true, the login flow will return a form error if the login identifier is not verified, which restores legacy behavior. If this value is false, the `continue_with` array will contain a `show_verification_ui` hook instead.\n\nThis flag is deprecated and will be removed in the future.\n\nThis governs the \"feature_flags.legacy_require_verified_login_error\" setting.", "type": "boolean" }, "kratos_feature_flags_password_profile_registration_node_group": { "description": "Configures the group for the password method in the registration flow.\n\nIf true, it sets the password method group value to \"password\" if it is the only method available. This is the legacy behavior.\nIf false is, it sets the password method group value to \"default\".\n\nThis governs the \"feature_flags.password_profile_registration_node_group\" setting.", "type": "boolean" }, "kratos_feature_flags_refresh_login_choose_address": { "description": "Render an address picker on the code refresh login screen\n\nIf true, a code-strategy refresh (privileged re-authentication) login renders a \"Send code to \u003caddress\u003e\" button per available code address instead of re-asking for the identifier. The identity is already fixed by the active session, so re-entering the identifier is unnecessary. It is safe to toggle this back and forth.\n\nThis governs the \"feature_flags.refresh_login_choose_address\" setting.", "type": "boolean" }, "kratos_feature_flags_use_continue_with_transitions": { "description": "Configures the Ory Kratos Session use_continue_with_transitions flag\n\nThis governs the \"feature_flags.use_continue_with_transitions\" setting.", "type": "boolean" }, "kratos_identity_schemas": { "$ref": "#/components/schemas/projectRevisionIdentitySchemas" }, "kratos_oauth2_provider_headers": { "description": "Configures the OAuth2 Provider Integration HTTP Headers\n\nThis governs the \"oauth2_provider.headers\" setting.", "type": "object" }, "kratos_oauth2_provider_override_return_to": { "description": "Kratos OAuth2 Provider Override Return To\n\nEnabling this allows Kratos to set the return_to parameter automatically to the OAuth2 request URL on the login flow, allowing complex flows such as recovery to continue to the initial OAuth2 flow.\n\nThis governs the \"oauth2_provider.override_return_to\" setting.", "type": "boolean" }, "kratos_oauth2_provider_url": { "description": "The Revisions' OAuth2 Provider Integration URL\n\nThis governs the \"oauth2_provider.url\" setting.", "type": "string" }, "kratos_preview_default_read_consistency_level": { "description": "Configures the default read consistency level for identity APIs\n\nThe read consistency level determines the consistency guarantee for reads:\n\nstrong (slow): The read is guaranteed to return the most recent data committed at the start of the read.\neventual (very fast): The result will return data that is about 4.8 seconds old.\n\nSetting the default consistency level to `eventual` may cause regressions in the future as we add consistency\ncontrols to more APIs. Currently, the following APIs will be affected by this setting:\n\n`GET /admin/identities`\n\nDefaults to \"strong\" for new and existing projects. This feature is in preview. Use with caution.\nThis governs the \"preview.default_read_consistency_level\" setting.", "type": "string" }, "kratos_secrets_cipher": { "description": "Configures the Ory Kratos Cipher Secret\n\nThis governs the \"secrets.cipher\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_secrets_cookie": { "description": "Configures the Ory Kratos Cookie Secret\n\nThis governs the \"secrets.cookie\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_secrets_default": { "description": "Configures the Ory Kratos Default Secret\n\nThis governs the \"secrets.default\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_secrets_pagination": { "description": "Configures the Ory Kratos Pagination Secret\n\nThis governs the \"secrets.pagination\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_security_account_enumeration_mitigate": { "description": "Configures if account enumeration should be mitigated when using identifier first login.\n\nThis governs the \"security.account_enumeration.mitigate\" setting.", "type": "boolean" }, "kratos_selfservice_allowed_return_urls": { "description": "Configures the Ory Kratos Allowed Return URLs\n\nThis governs the \"selfservice.allowed_return_urls\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_selfservice_default_browser_return_url": { "description": "Configures the Ory Kratos Default Return URL\n\nThis governs the \"selfservice.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_error_ui_url": { "description": "Configures the Ory Kratos Error UI URL\n\nThis governs the \"selfservice.flows.error.ui_url\" setting.", "type": "string" }, "kratos_selfservice_flows_login_after_code_default_browser_return_url": { "description": "Configures the Ory Kratos Login After Code Default Return URL\n\nThis governs the \"selfservice.flows.login.after.code.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_login_after_default_browser_return_url": { "description": "Configures the Ory Kratos Login Default Return URL\n\nThis governs the \"selfservice.flows.login.after.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_login_after_lookup_secret_default_browser_return_url": { "description": "Configures the Ory Kratos Login After Lookup Secret Default Return URL\n\nThis governs the \"selfservice.flows.login.after.lookup_secret.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_login_after_oidc_default_browser_return_url": { "description": "Configures the Ory Kratos Login After OIDC Default Return URL\n\nThis governs the \"selfservice.flows.login.after.oidc.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_login_after_passkey_default_browser_return_url": { "description": "Configures the Ory Kratos Login After Passkey Default Return URL\n\nThis governs the \"selfservice.flows.login.after.passkey.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_login_after_password_default_browser_return_url": { "description": "Configures the Ory Kratos Login After Password Default Return URL\n\nThis governs the \"selfservice.flows.login.after.password.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_login_after_totp_default_browser_return_url": { "description": "Configures the Ory Kratos Login After TOTP Default Return URL\n\nThis governs the \"selfservice.flows.login.after.totp.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_login_after_webauthn_default_browser_return_url": { "description": "Configures the Ory Kratos Login After WebAuthn Default Return URL\n\nThis governs the \"selfservice.flows.login.after.webauthn.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_login_lifespan": { "description": "Configures the Ory Kratos Login Lifespan\n\nThis governs the \"selfservice.flows.login.lifespan\" setting.", "type": "string" }, "kratos_selfservice_flows_login_style": { "description": "Configures the Ory Kratos Login Flow Style\n\nThis governs the \"selfservice.flows.login.style\" setting.\nPossible values are \"unified\" and \"identifier_first\".", "type": "string" }, "kratos_selfservice_flows_login_ui_url": { "description": "Configures the Ory Kratos Login UI URL\n\nThis governs the \"selfservice.flows.login.ui_url\" setting.", "type": "string" }, "kratos_selfservice_flows_logout_after_default_browser_return_url": { "description": "Configures the Ory Kratos Logout Default Return URL\n\nThis governs the \"selfservice.flows.logout.after.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_recovery_after_default_browser_return_url": { "description": "Configures the Ory Kratos Recovery Default Return URL\n\nThis governs the \"selfservice.flows.recovery.after.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_recovery_enabled": { "description": "Configures the Ory Kratos Recovery Enabled Setting\n\nThis governs the \"selfservice.flows.recovery.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_flows_recovery_lifespan": { "description": "Configures the Ory Kratos Recovery Lifespan\n\nThis governs the \"selfservice.flows.recovery.lifespan\" setting.", "type": "string" }, "kratos_selfservice_flows_recovery_notify_unknown_recipients": { "description": "Configures whether to notify unknown recipients of a Ory Kratos recovery flow\n\nThis governs the \"selfservice.flows.recovery.notify_unknown_recipients\" setting.", "type": "boolean" }, "kratos_selfservice_flows_recovery_ui_url": { "description": "Configures the Ory Kratos Recovery UI URL\n\nThis governs the \"selfservice.flows.recovery.ui_url\" setting.", "type": "string" }, "kratos_selfservice_flows_recovery_use": { "description": "Configures the Ory Kratos Recovery strategy to use (\"link\" or \"code\")\n\nThis governs the \"selfservice.flows.recovery.use\" setting.\nlink SelfServiceMessageVerificationStrategyLink\ncode SelfServiceMessageVerificationStrategyCode", "enum": [ "link", "code" ], "type": "string", "x-go-enum-desc": "link SelfServiceMessageVerificationStrategyLink\ncode SelfServiceMessageVerificationStrategyCode" }, "kratos_selfservice_flows_registration_after_code_default_browser_return_url": { "description": "Configures the Ory Kratos Registration After Code Default Return URL\n\nThis governs the \"selfservice.flows.registration.after.code.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_registration_after_default_browser_return_url": { "description": "Configures the Ory Kratos Registration Default Return URL\n\nThis governs the \"selfservice.flows.registration.after.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_registration_after_oidc_default_browser_return_url": { "description": "Configures the Ory Kratos Registration After OIDC Default Return URL\n\nThis governs the \"selfservice.flows.registration.after.oidc.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_registration_after_passkey_default_browser_return_url": { "description": "Configures the Ory Kratos Registration After Passkey Default Return URL\n\nThis governs the \"selfservice.flows.registration.after.passkey.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_registration_after_password_default_browser_return_url": { "description": "Configures the Ory Kratos Registration After Password Default Return URL\n\nThis governs the \"selfservice.flows.registration.after.password.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_registration_after_webauthn_default_browser_return_url": { "description": "Configures the Ory Kratos Registration After Webauthn Default Return URL\n\nThis governs the \"selfservice.flows.registration.after.webauthn.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_registration_enable_legacy_one_step": { "description": "Disable two-step registration\n\nTwo-step registration is a significantly improved sign up flow and recommended\nwhen using more than one sign up methods. To revert to one-step registration,\nset this to `true`.\n\nThis governs the \"selfservice.flows.registration.enable_legacy_one_step\" setting.", "type": "boolean" }, "kratos_selfservice_flows_registration_enabled": { "description": "Configures the Whether Ory Kratos Registration is Enabled\n\nThis governs the \"selfservice.flows.registration.enabled\" setting.0", "type": "boolean" }, "kratos_selfservice_flows_registration_lifespan": { "description": "Configures the Ory Kratos Registration Lifespan\n\nThis governs the \"selfservice.flows.registration.lifespan\" setting.", "type": "string" }, "kratos_selfservice_flows_registration_login_hints": { "description": "Configures the Ory Kratos Registration Login Hints\n\nShows helpful information when a user tries to sign up with a duplicate account.\n\nThis governs the \"selfservice.flows.registration.login_hints\" setting.", "type": "boolean" }, "kratos_selfservice_flows_registration_ui_url": { "description": "Configures the Ory Kratos Registration UI URL\n\nThis governs the \"selfservice.flows.registration.ui_url\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_after_default_browser_return_url": { "description": "Configures the Ory Kratos Settings Default Return URL\n\nThis governs the \"selfservice.flows.settings.after.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_after_lookup_secret_default_browser_return_url": { "description": "Configures the Ory Kratos Settings Default Return URL After Updating Lookup Secrets\n\nThis governs the \"selfservice.flows.settings.after.lookup_secret.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_after_oidc_default_browser_return_url": { "description": "Configures the Ory Kratos Settings Default Return URL After Updating Social Sign In\n\nThis governs the \"selfservice.flows.settings.after.oidc.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_after_passkey_default_browser_return_url": { "description": "Configures the Ory Kratos Settings Default Return URL After Updating Passkey\n\nThis governs the \"selfservice.flows.settings.after.passkey.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_after_password_default_browser_return_url": { "description": "Configures the Ory Kratos Settings Default Return URL After Updating Passwords\n\nThis governs the \"selfservice.flows.settings.after.password.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_after_profile_default_browser_return_url": { "description": "Configures the Ory Kratos Settings Default Return URL After Updating Profiles\n\nThis governs the \"selfservice.flows.settings.after.profile.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_after_totp_default_browser_return_url": { "description": "Configures the Ory Kratos Settings Default Return URL After Updating TOTP\n\nThis governs the \"selfservice.flows.settings.after.totp.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_after_webauthn_default_browser_return_url": { "description": "Configures the Ory Kratos Settings Default Return URL After Updating WebAuthn\n\nThis governs the \"selfservice.flows.settings.after.webauthn.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_lifespan": { "description": "Configures the Ory Kratos Settings Lifespan\n\nThis governs the \"selfservice.flows.settings.lifespan\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_privileged_session_max_age": { "description": "Configures the Ory Kratos Settings Privileged Session Max Age\n\nThis governs the \"selfservice.flows.settings.privileged_session_max_age\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_required_aal": { "description": "Configures the Ory Kratos Settings Required AAL\n\nThis governs the \"selfservice.flows.settings.required_aal\" setting.", "type": "string" }, "kratos_selfservice_flows_settings_ui_url": { "description": "Configures the Ory Kratos Settings UI URL\n\nThis governs the \"selfservice.flows.settings.ui_url\" setting.", "type": "string" }, "kratos_selfservice_flows_verification_after_default_browser_return_url": { "description": "Configures the Ory Kratos Verification Default Return URL\n\nThis governs the \"selfservice.flows.verification.after.default_browser_return_url\" setting.", "type": "string" }, "kratos_selfservice_flows_verification_enabled": { "description": "Configures the Ory Kratos Verification Enabled Setting\n\nThis governs the \"selfservice.flows.verification.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_flows_verification_lifespan": { "description": "Configures the Ory Kratos Verification Lifespan\n\nThis governs the \"selfservice.flows.verification.lifespan\" setting.", "type": "string" }, "kratos_selfservice_flows_verification_notify_unknown_recipients": { "description": "Configures whether to notify unknown recipients of a Ory Kratos verification flow\n\nThis governs the \"selfservice.flows.verification.notify_unknown_recipients\" setting.", "type": "boolean" }, "kratos_selfservice_flows_verification_ui_url": { "description": "Configures the Ory Kratos Verification UI URL\n\nThis governs the \"selfservice.flows.verification.ui_url\" setting.", "type": "string" }, "kratos_selfservice_flows_verification_use": { "description": "Configures the Ory Kratos Strategy to use for Verification\n\nThis governs the \"selfservice.flows.verification.use\" setting.\nlink SelfServiceMessageVerificationStrategyLink\ncode SelfServiceMessageVerificationStrategyCode", "enum": [ "link", "code" ], "type": "string", "x-go-enum-desc": "link SelfServiceMessageVerificationStrategyLink\ncode SelfServiceMessageVerificationStrategyCode" }, "kratos_selfservice_methods_captcha_config_allowed_domains": { "description": "Configures the CAPTCHA allowed domains list\n\nThis governs the \"selfservice.methods.captcha.config.allowed_domains\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_selfservice_methods_captcha_config_byo": { "description": "Configures whether to use BYO or managed widget\n\nReach out to your account manager to enable this feature.\n\nThis governs the \"selfservice.methods.captcha.config.byo\" setting.", "type": "boolean" }, "kratos_selfservice_methods_captcha_config_cf_turnstile_byo_secret": { "description": "Configures the Cloudflare Turnstile site secret for Ory BYO CAPTCHA protection\n\nThe site secret is private and will be never be shared with the client. This key is write only and the value will not be returned in response to a read request.\n\nReach out to your account manager to enable this feature.\n\nThis governs the \"selfservice.methods.captcha.config.cf_turnstile.secret\" setting.", "type": "string" }, "kratos_selfservice_methods_captcha_config_cf_turnstile_byo_sitekey": { "description": "Configures the Cloudflare Turnstile site key for Ory BYO CAPTCHA protection\n\nThe site key is public and will be shared with the client.\n\nReach out to your account manager to enable this feature.\n\nThis governs the \"selfservice.methods.captcha.config.cf_turnstile.sitekey\" setting.", "type": "string" }, "kratos_selfservice_methods_captcha_config_cf_turnstile_secret": { "description": "Configures the Cloudflare Turnstile site secret for managed CAPTCHA protection\n\nThe site secret is private and will be never be shared with the client. This key is write only and the value will not be returned in response to a read request.\n\nReach out to your account manager to enable this feature.\n\nThis governs the \"selfservice.methods.captcha.config.cf_turnstile.secret\" setting.", "type": "string" }, "kratos_selfservice_methods_captcha_config_cf_turnstile_sitekey": { "description": "Configures the Cloudflare Turnstile site key for managed CAPTCHA protection\n\nThe site key is public and will be shared with the client.\n\nReach out to your account manager to enable this feature.\n\nThis governs the \"selfservice.methods.captcha.config.cf_turnstile.sitekey\" setting.", "type": "string" }, "kratos_selfservice_methods_captcha_config_legacy_inject_node": { "description": "Configures legacy CAPTCHA node injection behavior\n\nReach out to your account manager to enable this feature.\n\nThis governs the \"selfservice.methods.captcha.config.legacy_inject_node\" setting.", "type": "boolean" }, "kratos_selfservice_methods_captcha_enabled": { "description": "Configures the Ory Kratos Self-Service Methods' Captcha Enabled Setting\n\nReach out to your account manager to enable this feature.\n\nThis governs the \"selfservice.methods.captcha.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_code_config_lifespan": { "description": "Configures the Ory Kratos Code Method's lifespan\n\nThis governs the \"selfservice.methods.code.config.lifespan\" setting.", "type": "string" }, "kratos_selfservice_methods_code_config_max_submissions": { "description": "Configures the maximum number of attempts to submit a one-time code in kratos.\n\nThis governs the \"selfservice.methods.code.max_submissions\" setting.", "format": "int64", "type": "integer" }, "kratos_selfservice_methods_code_config_missing_credential_fallback_enabled": { "description": "Enables a fallback method required in certain legacy use cases.\n\nThis governs the \"selfservice.methods.code.config.missing_credential_fallback_enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_code_enabled": { "description": "Configures whether Ory Kratos Code Method is enabled\n\nThis governs the \"selfservice.methods.code.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_code_mfa_enabled": { "description": "Configures whether the code method can be used to fulfil MFA flows\n\nThis governs the \"selfservice.methods.code.mfa_enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_code_passwordless_enabled": { "description": "Configures whether Ory Kratos Passwordless should use the Code Method\n\nThis governs the \"selfservice.methods.code.passwordless_enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_code_passwordless_login_fallback_enabled": { "description": "This setting allows the code method to always login a user with code if they have registered with another authentication method such as password or social sign in.\n\nThis governs the \"selfservice.methods.code.passwordless_login_fallback_enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_deviceauthn_config_android_app_ids": { "description": "Configures the allow-list of Android app signing-certificate digests that a device key may be bound to.\n\nThis governs the \"selfservice.methods.deviceauthn.config.android_app_ids\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_selfservice_methods_deviceauthn_config_first_factor": { "description": "Configures whether device authentication may be used as the sole first factor.\n\nWhen enabled, a confirmed device key with PIN or platform user\nverification can complete an AAL2 login in a single submission, without a\npassword or code. Defaults to false, which keeps device keys usable only\nas a second factor (step-up).\n\nThis governs the \"selfservice.methods.deviceauthn.config.first_factor\" setting.", "type": "boolean" }, "kratos_selfservice_methods_deviceauthn_config_insecure_allow_relaxed_attestation": { "description": "Configures whether Ory Kratos Device authentication accepts relaxed attestations for testing\n\nOnly allowed on development projects and forced off otherwise. Keys enrolled\nunder relaxation are short-lived and refused once this is turned off.\n\nThis governs the \"selfservice.methods.deviceauthn.config.insecure_allow_relaxed_attestation\" setting.", "type": "boolean" }, "kratos_selfservice_methods_deviceauthn_config_ios_app_ids": { "description": "Configures the allow-list of Apple App IDs that a device key may be bound to.\n\nThis governs the \"selfservice.methods.deviceauthn.config.ios_app_ids\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_selfservice_methods_deviceauthn_config_ios_biometric_first_factor": { "description": "Configures whether an iOS biometric device key may be used as the sole first factor.\n\nApple App Attest cannot prove biometric gating, so iOS keys with\n\"platform\" user verification count as a first factor only with this\nexplicit opt-in. Android keys are unaffected, as their user verification\nis attestation-verified. Defaults to false.\n\nThis governs the \"selfservice.methods.deviceauthn.config.ios_biometric_first_factor\" setting.", "type": "boolean" }, "kratos_selfservice_methods_deviceauthn_config_pin_max_attempts": { "description": "Configures the number of consecutive wrong-PIN attempts before a device key is locked.\n\nDefaults to 5; must be between 1 and 10. Once locked, the key's\npin_secret is invalidated and the key can no longer be used to log in\nuntil the user rotates its secret through the fallback login.\n\nThis governs the \"selfservice.methods.deviceauthn.config.pin_max_attempts\" setting.", "format": "int64", "type": "integer" }, "kratos_selfservice_methods_deviceauthn_enabled": { "description": "Configures whether Ory Kratos Device authentication is enabled\n\nThis governs the \"selfservice.methods.deviceauthn.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_link_config_base_url": { "description": "Configures the Base URL which Recovery, Verification, and Login Links Point to\n\nIt is recommended to leave this value empty. It will be appropriately configured to the best matching domain\n(e.g. when using custom domains) automatically.\n\nThis governs the \"selfservice.methods.link.config.base_url\" setting.", "type": "string" }, "kratos_selfservice_methods_link_config_lifespan": { "description": "Configures the Ory Kratos Link Method's lifespan\n\nThis governs the \"selfservice.methods.link.config.lifespan\" setting.", "type": "string" }, "kratos_selfservice_methods_link_enabled": { "description": "Configures whether Ory Kratos Link Method is enabled\n\nThis governs the \"selfservice.methods.link.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_lookup_secret_enabled": { "description": "Configures whether Ory Kratos TOTP Lookup Secret is enabled\n\nThis governs the \"selfservice.methods.lookup_secret.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_oidc_config_base_redirect_uri": { "description": "Configures the Ory Kratos Third Party / OpenID Connect base redirect URI\n\nThis governs the \"selfservice.methods.oidc.config.base_redirect_uri\" setting.", "type": "string" }, "kratos_selfservice_methods_oidc_config_providers": { "$ref": "#/components/schemas/projectRevisionThirdPartyLoginProviders" }, "kratos_selfservice_methods_oidc_enable_auto_link_policy": { "description": "Configures whether Ory Kratos allows auto-linking of OIDC credentials without a subject\n\nThis governs the \"selfservice.methods.oidc.enable_auto_link_policy\" setting.", "type": "boolean" }, "kratos_selfservice_methods_oidc_enabled": { "description": "Configures whether Ory Kratos Third Party / OpenID Connect Login is enabled\n\nThis governs the \"selfservice.methods.oidc.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_passkey_config_rp_display_name": { "description": "Configures the Ory Kratos Passkey RP Display Name\n\nThis governs the \"selfservice.methods.passkey.config.rp.display_name\" setting.", "type": "string" }, "kratos_selfservice_methods_passkey_config_rp_id": { "description": "Configures the Ory Kratos Passkey RP ID\n\nThis governs the \"selfservice.methods.passkey.config.rp.id\" setting.", "type": "string" }, "kratos_selfservice_methods_passkey_config_rp_origins": { "description": "Configures the Ory Kratos Passkey RP Origins\n\nThis governs the \"selfservice.methods.passkey.config.rp.origins\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_selfservice_methods_passkey_enabled": { "description": "Configures whether Ory Kratos Passkey authentication is enabled\n\nThis governs the \"selfservice.methods.passkey.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_password_config_haveibeenpwned_enabled": { "description": "Configures whether Ory Kratos Password HIBP Checks is enabled\n\nThis governs the \"selfservice.methods.password.config.haveibeenpwned_enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_password_config_identifier_similarity_check_enabled": { "description": "Configures whether Ory Kratos Password should disable the similarity policy.\n\nThis governs the \"selfservice.methods.password.config.identifier_similarity_check_enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_password_config_ignore_network_errors": { "description": "Configures whether Ory Kratos Password Should ignore HIBPWND Network Errors\n\nThis governs the \"selfservice.methods.password.config.ignore_network_errors\" setting.", "type": "boolean" }, "kratos_selfservice_methods_password_config_max_breaches": { "description": "Configures Ory Kratos Password Max Breaches Detection\n\nThis governs the \"selfservice.methods.password.config.max_breaches\" setting.", "format": "int64", "type": "integer" }, "kratos_selfservice_methods_password_config_min_password_length": { "description": "Configures the minimum length of passwords.\n\nThis governs the \"selfservice.methods.password.config.min_password_length\" setting.", "format": "int64", "type": "integer" }, "kratos_selfservice_methods_password_enabled": { "description": "Configures whether Ory Kratos Password Method is enabled\n\nThis governs the \"selfservice.methods.password.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_profile_enabled": { "description": "Configures whether Ory Kratos Profile Method is enabled\n\nThis governs the \"selfservice.methods.profile.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_saml_config_providers": { "$ref": "#/components/schemas/projectRevisionSamlProviders" }, "kratos_selfservice_methods_saml_enabled": { "description": "Configures whether Ory Kratos SAML Login is enabled\n\nThis governs the \"selfservice.methods.saml.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_totp_config_issuer": { "description": "Configures Ory Kratos TOTP Issuer\n\nThis governs the \"selfservice.methods.totp.config.issuer\" setting.", "type": "string" }, "kratos_selfservice_methods_totp_enabled": { "description": "Configures whether Ory Kratos TOTP Method is enabled\n\nThis governs the \"selfservice.methods.totp.enabled\" setting.", "type": "boolean" }, "kratos_selfservice_methods_webauthn_config_passwordless": { "description": "Configures whether Ory Kratos Webauthn is used for passwordless flows\n\nThis governs the \"selfservice.methods.webauthn.config.passwordless\" setting.", "type": "boolean" }, "kratos_selfservice_methods_webauthn_config_rp_display_name": { "description": "Configures the Ory Kratos Webauthn RP Display Name\n\nThis governs the \"selfservice.methods.webauthn.config.rp.display_name\" setting.", "type": "string" }, "kratos_selfservice_methods_webauthn_config_rp_icon": { "description": "Configures the Ory Kratos Webauthn RP Icon\n\nThis governs the \"selfservice.methods.webauthn.config.rp.icon\" setting.\nDeprecated: This value will be ignored due to security considerations.", "type": "string" }, "kratos_selfservice_methods_webauthn_config_rp_id": { "description": "Configures the Ory Kratos Webauthn RP ID\n\nThis governs the \"selfservice.methods.webauthn.config.rp.id\" setting.", "type": "string" }, "kratos_selfservice_methods_webauthn_config_rp_origins": { "description": "Configures the Ory Kratos Webauthn RP Origins\n\nThis governs the \"selfservice.methods.webauthn.config.rp.origins\" setting.", "items": { "type": "string" }, "type": "array" }, "kratos_selfservice_methods_webauthn_enabled": { "description": "Configures whether Ory Kratos Webauthn is enabled\n\nThis governs the \"selfservice.methods.webauthn.enabled\" setting.", "type": "boolean" }, "kratos_session_cookie_persistent": { "description": "Configures the Ory Kratos Session Cookie Persistent Attribute\n\nThis governs the \"session.cookie.persistent\" setting.", "type": "boolean" }, "kratos_session_cookie_same_site": { "description": "Configures the Ory Kratos Session Cookie SameSite Attribute\n\nThis governs the \"session.cookie.same_site\" setting.", "type": "string" }, "kratos_session_lifespan": { "description": "Configures the Ory Kratos Session Lifespan\n\nThis governs the \"session.lifespan\" setting.", "type": "string" }, "kratos_session_whoami_required_aal": { "description": "Configures the Ory Kratos Session Whoami AAL requirement\n\nThis governs the \"session.whoami.required_aal\" setting.", "type": "string" }, "kratos_session_whoami_tokenizer_templates": { "$ref": "#/components/schemas/normalizedProjectRevisionTokenizerTemplates" }, "name": { "description": "The project's name.", "type": "string" }, "organizations": { "$ref": "#/components/schemas/organizations" }, "project_id": { "description": "The Revision's Project ID", "format": "uuid", "type": "string" }, "project_revision_hooks": { "$ref": "#/components/schemas/projectRevisionHooks" }, "scim_clients": { "$ref": "#/components/schemas/projectRevisionScimClients" }, "serve_admin_cors_allowed_origins": { "description": "Configures the CORS Allowed Origins on admin APIs\n\nThis governs the \"serve.admin.cors.allowed_origins\" setting.", "items": { "type": "string" }, "type": "array" }, "serve_admin_cors_enabled": { "description": "Enable CORS headers on all admin APIs\n\nThis governs the \"serve.admin.cors.enabled\" setting.", "type": "boolean" }, "serve_public_cors_allowed_origins": { "description": "Configures the CORS Allowed Origins on public APIs\n\nThis governs the \"serve.public.cors.allowed_origins\" setting.", "items": { "type": "string" }, "type": "array" }, "serve_public_cors_enabled": { "description": "Enable CORS headers on all public APIs\n\nThis governs the \"serve.public.cors.enabled\" setting.", "type": "boolean" }, "strict_security": { "description": "Whether the project should employ strict security measures. Setting this to true is recommended for going into production.", "type": "boolean" }, "talos_cache_enabled": { "description": "Talos cache enabled.\n\nWhen true, API key verification results are cached. Revoked keys may be\naccepted until the cached entry expires. When false, every verification\nreads the database and revocations take effect immediately.", "type": "boolean" }, "talos_cache_ttl": { "description": "Talos cache TTL controls how long API key verification results are cached.", "example": "5m", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "talos_credentials_api_keys_default_ttl": { "description": "Talos API keys default TTL.", "example": "1h", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "talos_credentials_api_keys_max_ttl": { "description": "Talos API keys max TTL.", "example": "24h", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "talos_credentials_api_keys_prefix_current": { "description": "Talos API keys prefix (current).", "type": "string" }, "talos_credentials_api_keys_prefix_public_current": { "description": "Talos API keys public prefix (current).", "type": "string" }, "talos_credentials_api_keys_prefix_public_retired": { "description": "Talos API keys public prefix (retired).\n\nPreviously active public API key prefixes kept for verification of outstanding tokens.\nThe first element of this list was the most recently retired active prefix.", "items": { "type": "string" }, "type": "array" }, "talos_credentials_api_keys_prefix_retired": { "description": "Talos API keys prefix (retired).\n\nPreviously active API key prefixes kept for verification of outstanding tokens.\nThe first element of this list was the most recently retired active prefix.", "items": { "type": "string" }, "type": "array" }, "talos_credentials_derived_tokens_default_ttl": { "description": "Talos derived tokens default TTL (applies to both JWT and macaroon tokens).", "example": "1h", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "talos_credentials_derived_tokens_jwt_signing_key_id": { "description": "Talos derived tokens JWT signing key ID (kid).", "type": "string" }, "talos_credentials_derived_tokens_jwt_signing_keys_urls": { "description": "Talos derived tokens JWT signing key URLs.", "items": { "type": "string" }, "type": "array" }, "talos_credentials_derived_tokens_macaroon_prefix_current": { "description": "Talos derived tokens macaroon prefix (current).", "type": "string" }, "talos_credentials_derived_tokens_macaroon_prefix_retired": { "description": "Talos derived tokens macaroon prefix (retired).\n\nPreviously active macaroon prefixes kept for verification of outstanding tokens.\nThe first element of this list was the most recently retired active prefix.", "items": { "type": "string" }, "type": "array" }, "talos_credentials_issuer": { "description": "Talos credentials issuer URL.", "type": "string" }, "talos_credentials_issuer_retired": { "description": "Talos credentials retired issuer URLs (deprecated).\n\nDeprecated: values-only view of talos_credentials_issuer_retired_entries,\nkept so already-released SDKs that decode this field as an array of strings\nkeep working. It is output only: reads are derived from the entries field\nand writes to it are ignored. Use talos_credentials_issuer_retired_entries\ninstead.", "items": { "type": "string" }, "readOnly": true, "type": "array" }, "talos_credentials_issuer_retired_entries": { "$ref": "#/components/schemas/talosRetiredValues" }, "talos_rate_limit_enabled": { "description": "Talos rate limit enabled.\n\nWhen true, server-side rate limiting is enforced for API key verifications.", "type": "boolean" }, "talos_secrets_hmac_current": { "description": "TalosSecretsHMACCurrent stores the current HMAC symmetric key as a\nplain secret string.", "type": "string" }, "talos_secrets_hmac_retired": { "description": "TalosSecretsHMACRetired stores previously active HMAC symmetric keys as an\narray of strings (deprecated).\n\nDeprecated: values-only view of talos_secrets_hmac_retired_entries, kept so\nalready-released SDKs that decode this field as an array of strings keep\nworking. It is output only and writes to it are ignored. HMAC secrets are\nserver-managed and redacted on output, so this field is always empty on the\nwire. Use talos_secrets_hmac_retired_entries instead.", "items": { "type": "string" }, "readOnly": true, "type": "array" }, "talos_secrets_hmac_retired_entries": { "$ref": "#/components/schemas/talosRetiredValues" }, "updated_at": { "description": "Last Time Project's Revision was Updated", "format": "date-time", "readOnly": true, "type": "string" } }, "required": [ "name" ], "type": "object" }, "normalizedProjectRevisionHook": { "properties": { "config_key": { "description": "The Hooks Config Key", "type": "string" }, "created_at": { "description": "The Project's Revision Creation Date", "format": "date-time", "readOnly": true, "type": "string" }, "hook": { "description": "The Hook Type", "type": "string" }, "id": { "description": "ID of the entry", "format": "uuid", "type": "string" }, "notify_previous_addresses_config_recipients": { "description": "The recipients to be notified in case of a change of the users verified email addresses. Possible values are: \"all\", \"all_verified\", \"removed\" (only notify about removed email addresses)", "example": "all_verified", "type": "string" }, "project_revision_id": { "description": "The Revision's ID this schema belongs to", "format": "uuid", "type": "string" }, "updated_at": { "description": "Last Time Project's Revision was Updated", "format": "date-time", "readOnly": true, "type": "string" }, "web_hook_config_auth_api_key_in": { "description": "Whether to send the API Key in the HTTP Header or as a HTTP Cookie", "example": "header", "type": "string" }, "web_hook_config_auth_api_key_name": { "description": "The name of the api key", "example": "X-API-Key", "type": "string" }, "web_hook_config_auth_api_key_value": { "description": "The value of the api key", "example": "eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ", "type": "string" }, "web_hook_config_auth_basic_auth_password": { "description": "The password to be sent in the HTTP Basic Auth Header", "type": "string" }, "web_hook_config_auth_basic_auth_user": { "description": "The username to be sent in the HTTP Basic Auth Header", "type": "string" }, "web_hook_config_auth_type": { "description": "HTTP Auth Method to use for the Web-Hook", "type": "string" }, "web_hook_config_body": { "description": "URI pointing to the JsonNet template used for Web-Hook payload generation. Only used for those HTTP methods, which support HTTP body payloads.", "example": "base64://ZnVuY3Rpb24oY3R4KSB7CiAgaWRlbnRpdHlfaWQ6IGlmIGN0eFsiaWRlbnRpdHkiXSAhPSBudWxsIHRoZW4gY3R4LmlkZW50aXR5LmlkLAp9=", "type": "string" }, "web_hook_config_can_interrupt": { "description": "If enabled allows the web hook to interrupt / abort the self-service flow. It only applies to certain flows (registration/verification/login/settings) and requires a valid response format.", "type": "boolean" }, "web_hook_config_method": { "description": "The HTTP method to use (GET, POST, etc) for the Web-Hook", "example": "POST", "type": "string" }, "web_hook_config_response_ignore": { "description": "Whether to ignore the Web Hook response", "type": "boolean" }, "web_hook_config_response_parse": { "description": "Whether to parse the Web Hook response", "type": "boolean" }, "web_hook_config_url": { "description": "The URL the Web-Hook should call", "example": "https://www.example.org/web-hook-listener", "type": "string" } }, "required": [ "config_key", "hook" ], "type": "object" }, "normalizedProjectRevisionIdentitySchema": { "properties": { "created_at": { "description": "The Project's Revision Creation Date", "format": "date-time", "readOnly": true, "type": "string" }, "id": { "description": "The unique ID of this entry.", "format": "uuid", "type": "string" }, "identity_schema": { "$ref": "#/components/schemas/managedIdentitySchema" }, "identity_schema_id": { "$ref": "#/components/schemas/NullUUID" }, "import_id": { "description": "The imported (named) ID of the Identity Schema referenced in the Ory Kratos config.", "type": "string" }, "import_url": { "description": "The ImportURL can be used to import an Identity Schema from a bse64 encoded string.\nIn the future, this key also support HTTPS and other sources!\n\nIf you import an Ory Kratos configuration, this would be akin to the `identity.schemas.#.url` key.\n\nThe configuration will always return the import URL when you fetch it from the API.", "example": "base64://ey...", "type": "string" }, "is_default": { "description": "If true sets the default schema for identities\n\nOnly one schema can ever be the default schema. If you\ntry to add two schemas with default to true, the\nrequest will fail.", "type": "boolean" }, "preset": { "description": "Use a preset instead of a custom identity schema.", "type": "string" }, "project_revision_id": { "description": "The Revision's ID this schema belongs to", "format": "uuid", "type": "string" }, "selfservice_selectable": { "type": "boolean" }, "updated_at": { "description": "Last Time Project's Revision was Updated", "format": "date-time", "readOnly": true, "type": "string" } }, "type": "object" }, "normalizedProjectRevisionIdentitySchemas": { "items": { "$ref": "#/components/schemas/normalizedProjectRevisionIdentitySchema" }, "type": "array" }, "normalizedProjectRevisionSAMLProvider": { "properties": { "audience_override_base_url": { "$ref": "#/components/schemas/String" }, "created_at": { "description": "The Project's Revision Creation Date", "format": "date-time", "readOnly": true, "type": "string" }, "id": { "format": "uuid", "type": "string" }, "label": { "description": "Label represents an optional label which can be used in the UI generation.", "type": "string" }, "mapper_url": { "description": "Mapper specifies the JSONNet code snippet which uses the OpenID Connect Provider's data (e.g. GitHub or Google\nprofile information) to hydrate the identity's data.", "type": "string" }, "organization_id": { "$ref": "#/components/schemas/NullUUID" }, "project_revision_id": { "description": "The Revision's ID this schema belongs to", "format": "uuid", "type": "string" }, "provider_id": { "description": "ID is the provider's ID", "type": "string" }, "proxy_acs_url": { "$ref": "#/components/schemas/String" }, "proxy_saml_audience_override": { "$ref": "#/components/schemas/String" }, "raw_idp_metadata_xml": { "description": "RawIDPMetadataXML is the raw XML metadata of the IDP.", "type": "string" }, "state": { "description": "State indicates the state of the provider\n\nOnly providers with state `enabled` will be used for authentication\nenabled ThirdPartyProviderStateEnabled\ndisabled ThirdPartyProviderStateDisabled", "enum": [ "enabled", "disabled" ], "type": "string", "x-go-enum-desc": "enabled ThirdPartyProviderStateEnabled\ndisabled ThirdPartyProviderStateDisabled" }, "update_identity_on_login": { "description": "UpdateIdentityOnLogin controls whether the identity is updated from SAML\nclaims on each login.\n\nPossible values are \"never\" (default) and \"automatic\".\nnever UpdateIdentityOnLoginNever UpdateIdentityOnLoginNever disables identity updates on login (default).\nautomatic UpdateIdentityOnLoginAutomatic UpdateIdentityOnLoginAutomatic re-runs the Jsonnet claims mapper on every login and updates the identity's traits and metadata automatically.", "enum": [ "never", "automatic" ], "type": "string", "x-go-enum-desc": "never UpdateIdentityOnLoginNever UpdateIdentityOnLoginNever disables identity updates on login (default).\nautomatic UpdateIdentityOnLoginAutomatic UpdateIdentityOnLoginAutomatic re-runs the Jsonnet claims mapper on every login and updates the identity's traits and metadata automatically." }, "updated_at": { "description": "Last Time Project's Revision was Updated", "format": "date-time", "readOnly": true, "type": "string" }, "valid_to": { "description": "Valid to dates of all signing certs associated with the SAML connection", "items": { "type": "string" }, "readOnly": true, "type": "array" } }, "type": "object" }, "normalizedProjectRevisionScimClient": { "description": "SCIMClient represents a SCIM client configuration to be used by an external\nidentity provider.", "properties": { "authorization_header_secret": { "description": "The secret that the client uses in the authorization header to authenticate itself.", "type": "string" }, "client_id": { "description": "The unique ID of the SCIM server.", "type": "string" }, "created_at": { "description": "The SCIM client's creation time", "format": "date-time", "readOnly": true, "type": "string" }, "id": { "format": "uuid", "type": "string" }, "label": { "description": "The SCIM server's label", "type": "string" }, "mapper_url": { "description": "Mapper specifies the JSONNet code snippet which uses the SCIM provider's data\nto hydrate the identity's data.", "type": "string" }, "organization_id": { "description": "OrganizationID is the organization ID for this SCIM server.", "format": "uuid", "type": "string" }, "proxy_scim_server_url": { "$ref": "#/components/schemas/String" }, "state": { "description": "State indicates the state of the SCIM server\n\nOnly servers with state `enabled` will be available for SCIM provisioning.\nenabled ThirdPartyProviderStateEnabled\ndisabled ThirdPartyProviderStateDisabled", "enum": [ "enabled", "disabled" ], "type": "string", "x-go-enum-desc": "enabled ThirdPartyProviderStateEnabled\ndisabled ThirdPartyProviderStateDisabled" }, "updated_at": { "description": "Last time the SCIM client was updated", "format": "date-time", "readOnly": true, "type": "string" } }, "required": [ "organization_id", "client_id", "label", "mapper_url", "authorization_header_secret" ], "type": "object" }, "normalizedProjectRevisionThirdPartyProvider": { "properties": { "aal2_acr_values": { "description": "AAL2ACRValues lists upstream OIDC `acr` claim values that should\nelevate the resulting Kratos session to AAL2. Empty means the\nupstream `acr` claim is ignored when deciding session AAL.", "items": { "type": "string" }, "type": "array" }, "aal2_amr_values": { "description": "AAL2AMRValues lists upstream OIDC `amr` claim values that should\nelevate the resulting Kratos session to AAL2 when any of them\nappears in the upstream `amr` array. Empty means the upstream\n`amr` claim is ignored when deciding session AAL.", "items": { "type": "string" }, "type": "array" }, "account_linking_mode": { "description": "AccountLinkingMode controls how account conflicts are resolved for this provider.\n\nPossible values are `confirm_with_existing_credential` (default) and `automatic`.\n`automatic` silently links accounts when the provider verifies email ownership.\nOnly supported for `apple` and `google` providers.\nautomatic AccountLinkingModeAutomatic AccountLinkingModeAutomatic silently links accounts if the provider verifies email ownership.\nconfirm_with_existing_credential AccountLinkingModeConfirmWithExistingCredential AccountLinkingModeConfirmWithExistingCredential requires the user to confirm the account linking by providing an existing credential.", "enum": [ "automatic", "confirm_with_existing_credential" ], "type": "string", "x-go-enum-desc": "automatic AccountLinkingModeAutomatic AccountLinkingModeAutomatic silently links accounts if the provider verifies email ownership.\nconfirm_with_existing_credential AccountLinkingModeConfirmWithExistingCredential AccountLinkingModeConfirmWithExistingCredential requires the user to confirm the account linking by providing an existing credential." }, "additional_id_token_audiences": { "description": "AdditionalIDTokenAudiences is a list of additional audiences allowed in the ID Token.\n\nThis is only relevant in OIDC flows that submit an IDToken instead of using the callback from the OIDC provider.", "items": { "type": "string" }, "type": "array" }, "apple_private_key": { "$ref": "#/components/schemas/String" }, "apple_private_key_id": { "description": "Apple Private Key Identifier\n\nSign In with Apple Private Key Identifier needed for generating a JWT token for client secret", "example": "UX56C66723", "type": "string" }, "apple_team_id": { "description": "Apple Developer Team ID\n\nApple Developer Team ID needed for generating a JWT token for client secret", "example": "KP76DQS54M", "type": "string" }, "auth_url": { "description": "AuthURL is the authorize url, typically something like: https://example.org/oauth2/auth\nShould only be used when the OAuth2 / OpenID Connect server is not supporting OpenID Connect Discovery and when\n`provider` is set to `generic`.", "example": "https://www.googleapis.com/oauth2/v2/auth", "type": "string" }, "azure_tenant": { "description": "Tenant is the Azure AD Tenant to use for authentication, and must be set when `provider` is set to `microsoft`.\n\nCan be either `common`, `organizations`, `consumers` for a multitenant application or a specific tenant like\n`8eaef023-2b34-4da1-9baa-8bc8c9d6a490` or `contoso.onmicrosoft.com`.", "example": "contoso.onmicrosoft.com", "type": "string" }, "claims_source": { "$ref": "#/components/schemas/String" }, "client_id": { "description": "ClientID is the application's Client ID.", "type": "string" }, "client_secret": { "$ref": "#/components/schemas/String" }, "created_at": { "description": "The Project's Revision Creation Date", "format": "date-time", "readOnly": true, "type": "string" }, "fedcm_config_url": { "$ref": "#/components/schemas/String" }, "id": { "format": "uuid", "type": "string" }, "issuer_url": { "description": "IssuerURL is the OpenID Connect Server URL. You can leave this empty if `provider` is not set to `generic`.\nIf set, neither `auth_url` nor `token_url` are required.", "example": "https://accounts.google.com", "type": "string" }, "label": { "description": "Label represents an optional label which can be used in the UI generation.", "type": "string" }, "mapper_url": { "description": "Mapper specifies the JSONNet code snippet which uses the OpenID Connect Provider's data (e.g. GitHub or Google\nprofile information) to hydrate the identity's data.", "type": "string" }, "net_id_token_origin_header": { "$ref": "#/components/schemas/String" }, "organization_id": { "$ref": "#/components/schemas/NullUUID" }, "pkce": { "enum": [ "auto", "never", "force" ], "nullable": true }, "project_revision_id": { "description": "The Revision's ID this provider belongs to", "format": "uuid", "type": "string" }, "provider": { "description": "Provider is either \"generic\" for a generic OAuth 2.0 / OpenID Connect Provider or one of:\ngeneric\ngoogle\ngithub\ngitlab\nmicrosoft\ndiscord\nslack\nfacebook\nvk\nyandex\napple", "example": "google", "type": "string" }, "provider_id": { "description": "ID is the provider's ID", "type": "string" }, "proxy_oidc_redirect_url": { "description": "Proxy OIDC Redirect URL if overriding with a customer-controlled URL", "readOnly": true, "type": "string" }, "requested_claims": { "$ref": "#/components/schemas/JSONRawMessage" }, "scope": { "description": "Scope specifies optional requested permissions.", "items": { "type": "string" }, "type": "array" }, "state": { "description": "State indicates the state of the provider\n\nOnly providers with state `enabled` will be used for authentication\nenabled ThirdPartyProviderStateEnabled\ndisabled ThirdPartyProviderStateDisabled", "enum": [ "enabled", "disabled" ], "type": "string", "x-go-enum-desc": "enabled ThirdPartyProviderStateEnabled\ndisabled ThirdPartyProviderStateDisabled" }, "subject_source": { "$ref": "#/components/schemas/String" }, "token_url": { "description": "TokenURL is the token url, typically something like: https://example.org/oauth2/token\n\nShould only be used when the OAuth2 / OpenID Connect server is not supporting OpenID Connect Discovery and when\n`provider` is set to `generic`.", "example": "https://www.googleapis.com/oauth2/v4/token", "type": "string" }, "update_identity_on_login": { "description": "UpdateIdentityOnLogin controls whether the identity is updated from OIDC\nclaims on each login.\n\nPossible values are \"never\" (default) and \"automatic\".\nnever UpdateIdentityOnLoginNever UpdateIdentityOnLoginNever disables identity updates on login (default).\nautomatic UpdateIdentityOnLoginAutomatic UpdateIdentityOnLoginAutomatic re-runs the Jsonnet claims mapper on every login and updates the identity's traits and metadata automatically.", "enum": [ "never", "automatic" ], "type": "string", "x-go-enum-desc": "never UpdateIdentityOnLoginNever UpdateIdentityOnLoginNever disables identity updates on login (default).\nautomatic UpdateIdentityOnLoginAutomatic UpdateIdentityOnLoginAutomatic re-runs the Jsonnet claims mapper on every login and updates the identity's traits and metadata automatically." }, "updated_at": { "description": "Last Time Project's Revision was Updated", "format": "date-time", "readOnly": true, "type": "string" } }, "type": "object" }, "normalizedProjectRevisionTokenizerTemplate": { "properties": { "claims_mapper_url": { "description": "Claims mapper URL", "type": "string" }, "created_at": { "description": "The Project's Revision Creation Date", "format": "date-time", "readOnly": true, "type": "string" }, "id": { "description": "The revision ID.", "format": "uuid", "readOnly": true, "type": "string" }, "jwks_url": { "description": "JSON Web Key URL", "type": "string" }, "key": { "description": "The unique key of the template", "type": "string" }, "project_revision_id": { "description": "The Revision's ID this schema belongs to", "format": "uuid", "type": "string" }, "subject_source": { "default": "id", "description": "Subject source for the tokenizer\n\nCan be either id or external_id or empty", "enum": [ "id", "external_id" ], "type": "string" }, "ttl": { "default": "1m", "description": "Token time to live", "example": "1h", "pattern": "^([0-9]+([.][0-9]+)?(ns|us|µs|ms|s|m|h))+$", "type": "string" }, "updated_at": { "description": "Last Time Project's Revision was Updated", "format": "date-time", "readOnly": true, "type": "string" } }, "type": "object" }, "normalizedProjectRevisionTokenizerTemplates": { "items": { "$ref": "#/components/schemas/normalizedProjectRevisionTokenizerTemplate" }, "type": "array" }, "normalizedProjects": { "items": { "$ref": "#/components/schemas/normalizedProject" }, "type": "array" }, "nullBool": { "nullable": true, "type": "boolean" }, "nullInt64": { "nullable": true, "type": "integer" }, "nullJsonRawMessage": { "description": "NullJSONRawMessage represents a json.RawMessage that works well with JSON, SQL, and Swagger and is NULLable-", "nullable": true, "type": "object" }, "nullString": { "type": "string" }, "nullTime": { "format": "date-time", "title": "NullTime implements sql.NullTime functionality.", "type": "string" }, "oAuth2Client": { "description": "OAuth 2.0 Clients are used to perform OAuth 2.0 and OpenID Connect flows. Usually, OAuth 2.0 clients are\ngenerated for applications which want to consume your OAuth 2.0 or OpenID Connect capabilities.", "properties": { "access_token_strategy": { "description": "OAuth 2.0 Access Token Strategy\n\nAccessTokenStrategy is the strategy used to generate access tokens.\nValid options are `jwt` and `opaque`. `jwt` is a bad idea, see https://www.ory.com/docs/oauth2-oidc/jwt-access-token\nSetting the strategy here overrides the global setting in `strategies.access_token`.", "type": "string" }, "allowed_cors_origins": { "description": "OAuth 2.0 Client Allowed CORS Origins\n\nOne or more URLs (scheme://host[:port]) which are allowed to make CORS requests\nto the /oauth/token endpoint. If this array is empty, the server's CORS origin configuration (`CORS_ALLOWED_ORIGINS`)\nwill be used instead. If this array is set, the allowed origins are appended to the server's CORS origin configuration.\nBe aware that environment variable `CORS_ENABLED` MUST be set to `true` for this to work.", "items": { "type": "string" }, "type": "array" }, "audience": { "description": "OAuth 2.0 Client Audience\n\nAn allow-list defining the audiences this client is allowed to request tokens for. An audience limits\nthe applicability of an OAuth 2.0 Access Token to, for example, certain API endpoints. The value is a list\nof URLs. URLs MUST NOT contain whitespaces.", "example": "https://mydomain.com/api/users, https://mydomain.com/api/posts", "items": { "type": "string" }, "type": "array" }, "authorization_code_grant_access_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "authorization_code_grant_id_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "authorization_code_grant_refresh_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "backchannel_logout_session_required": { "description": "OpenID Connect Back-Channel Logout Session Required\n\nBoolean value specifying whether the RP requires that a sid (session ID) Claim be included in the Logout\nToken to identify the RP session with the OP when the backchannel_logout_uri is used.\nIf omitted, the default value is false.", "type": "boolean" }, "backchannel_logout_uri": { "description": "OpenID Connect Back-Channel Logout URI\n\nRP URL that will cause the RP to log itself out when sent a Logout Token by the OP.", "type": "string" }, "client_credentials_grant_access_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "client_id": { "description": "OAuth 2.0 Client ID\n\nThe ID is immutable. If no ID is provided, a UUID4 will be generated.", "type": "string" }, "client_name": { "description": "OAuth 2.0 Client Name\n\nThe human-readable name of the client to be presented to the\nend-user during authorization.", "type": "string" }, "client_secret": { "description": "OAuth 2.0 Client Secret\n\nThe secret will be included in the create request as cleartext, and then\nnever again. The secret is kept in hashed format and is not recoverable once lost.", "type": "string" }, "client_secret_expires_at": { "description": "OAuth 2.0 Client Secret Expires At\n\nThe field is currently not supported and its value is always 0.", "format": "int64", "type": "integer" }, "client_uri": { "description": "OAuth 2.0 Client URI\n\nClientURI is a URL string of a web page providing information about the client.\nIf present, the server SHOULD display this URL to the end-user in\na clickable fashion.", "type": "string" }, "contacts": { "description": "OAuth 2.0 Client Contact\n\nAn array of strings representing ways to contact people responsible\nfor this client, typically email addresses.", "example": "help@example.org", "items": { "type": "string" }, "type": "array" }, "created_at": { "description": "OAuth 2.0 Client Creation Date\n\nCreatedAt returns the timestamp of the client's creation.", "format": "date-time", "type": "string" }, "device_authorization_grant_access_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "device_authorization_grant_id_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "device_authorization_grant_refresh_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "frontchannel_logout_session_required": { "description": "OpenID Connect Front-Channel Logout Session Required\n\nBoolean value specifying whether the RP requires that iss (issuer) and sid (session ID) query parameters be\nincluded to identify the RP session with the OP when the frontchannel_logout_uri is used.\nIf omitted, the default value is false.", "type": "boolean" }, "frontchannel_logout_uri": { "description": "OpenID Connect Front-Channel Logout URI\n\nRP URL that will cause the RP to log itself out when rendered in an iframe by the OP. An iss (issuer) query\nparameter and a sid (session ID) query parameter MAY be included by the OP to enable the RP to validate the\nrequest and to determine which of the potentially multiple sessions is to be logged out; if either is\nincluded, both MUST be.", "type": "string" }, "grant_types": { "description": "OAuth 2.0 Client Grant Types\n\nAn array of OAuth 2.0 grant types the client is allowed to use. Can be one\nof:\n\nClient Credentials Grant: `client_credentials`\nAuthorization Code Grant: `authorization_code`\nOpenID Connect Implicit Grant (deprecated!): `implicit`\nRefresh Token Grant: `refresh_token`\nOAuth 2.0 Token Exchange: `urn:ietf:params:oauth:grant-type:jwt-bearer`\nOAuth 2.0 Device Code Grant: `urn:ietf:params:oauth:grant-type:device_code`", "items": { "type": "string" }, "type": "array" }, "implicit_grant_access_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "implicit_grant_id_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "jwks": { "$ref": "#/components/schemas/jsonWebKeySet" }, "jwks_uri": { "description": "OAuth 2.0 Client JSON Web Key Set URL\n\nURL for the Client's JSON Web Key Set [JWK] document. If the Client signs requests to the Server, it contains\nthe signing key(s) the Server uses to validate signatures from the Client. The JWK Set MAY also contain the\nClient's encryption keys(s), which are used by the Server to encrypt responses to the Client. When both signing\nand encryption keys are made available, a use (Key Use) parameter value is REQUIRED for all keys in the referenced\nJWK Set to indicate each key's intended usage. Although some algorithms allow the same key to be used for both\nsignatures and encryption, doing so is NOT RECOMMENDED, as it is less secure. The JWK x5c parameter MAY be used\nto provide X.509 representations of keys provided. When used, the bare key values MUST still be present and MUST\nmatch those in the certificate.", "type": "string" }, "jwt_bearer_grant_access_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "logo_uri": { "description": "OAuth 2.0 Client Logo URI\n\nA URL string referencing the client's logo.", "type": "string" }, "metadata": { "$ref": "#/components/schemas/JSONRawMessage" }, "owner": { "description": "OAuth 2.0 Client Owner\n\nOwner is a string identifying the owner of the OAuth 2.0 Client.", "type": "string" }, "policy_uri": { "description": "OAuth 2.0 Client Policy URI\n\nPolicyURI is a URL string that points to a human-readable privacy policy document\nthat describes how the deployment organization collects, uses,\nretains, and discloses personal data.", "type": "string" }, "post_logout_redirect_uris": { "description": "Allowed Post-Redirect Logout URIs\n\nArray of URLs supplied by the RP to which it MAY request that the End-User's User Agent be redirected using the\npost_logout_redirect_uri parameter after a logout has been performed.", "items": { "type": "string" }, "type": "array" }, "redirect_uris": { "description": "OAuth 2.0 Client Redirect URIs\n\nRedirectURIs is an array of allowed redirect urls for the client.", "example": "http://mydomain/oauth/callback", "items": { "type": "string" }, "type": "array" }, "refresh_token_grant_access_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "refresh_token_grant_id_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "refresh_token_grant_refresh_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "registration_access_token": { "description": "OpenID Connect Dynamic Client Registration Access Token\n\nRegistrationAccessToken can be used to update, get, or delete the OAuth2 Client. It is sent when creating a client\nusing Dynamic Client Registration.", "type": "string" }, "registration_client_uri": { "description": "OpenID Connect Dynamic Client Registration URL\n\nRegistrationClientURI is the URL used to update, get, or delete the OAuth2 Client.", "type": "string" }, "request_object_signing_alg": { "description": "OpenID Connect Request Object Signing Algorithm\n\nJWS [JWS] alg algorithm [JWA] that MUST be used for signing Request Objects sent to the OP. All Request Objects\nfrom this Client MUST be rejected, if not signed with this algorithm.", "type": "string" }, "request_uris": { "description": "OpenID Connect Request URIs\n\nArray of request_uri values that are pre-registered by the RP for use at the OP. Servers MAY cache the\ncontents of the files referenced by these URIs and not retrieve them at the time they are used in a request.\nOPs can require that request_uri values used be pre-registered with the require_request_uri_registration\ndiscovery parameter.", "items": { "type": "string" }, "type": "array" }, "response_types": { "description": "OAuth 2.0 Client Response Types\n\nAn array of the OAuth 2.0 response type strings that the client can\nuse at the authorization endpoint. Possible values are:\n\n`code` for Authorization Code Grant.\n`token` or `id_token` or `token id_token` for OpenID Connect Implicit Grant (not recommended).\n`code token` or `code id_token` or `code token id_token` for OpenID Connect Hybrid Flow (not recommended).", "items": { "type": "string" }, "type": "array" }, "scope": { "description": "OAuth 2.0 Client Scope\n\nScope is a string containing a space-separated list of scope values (as\ndescribed in Section 3.3 of OAuth 2.0 [RFC6749]) that the client\ncan use when requesting access tokens.", "example": "scope1 scope-2 scope.3 scope:4", "type": "string" }, "sector_identifier_uri": { "description": "OpenID Connect Sector Identifier URI\n\nURL using the https scheme to be used in calculating Pseudonymous Identifiers by the OP. The URL references a\nfile with a single JSON array of redirect_uri values.", "type": "string" }, "skip_consent": { "description": "SkipConsent skips the consent screen for this client. This field can only\nbe set from the admin API.", "type": "boolean" }, "skip_logout_consent": { "description": "SkipLogoutConsent skips the logout consent screen for this client. This field can only\nbe set from the admin API.", "type": "boolean" }, "subject_type": { "description": "OpenID Connect Subject Type\n\nThe `subject_types_supported` Discovery parameter contains a\nlist of the supported subject_type values for this server. Valid types include `pairwise` and `public`.", "type": "string" }, "token_endpoint_auth_method": { "default": "client_secret_basic", "description": "OAuth 2.0 Token Endpoint Authentication Method\n\nRequested Client Authentication method for the Token Endpoint. The options are:\n\n`client_secret_basic`: (default) Send `client_id` and `client_secret` as `application/x-www-form-urlencoded` encoded in the HTTP Authorization header.\n`client_secret_post`: Send `client_id` and `client_secret` as `application/x-www-form-urlencoded` in the HTTP body.\n`private_key_jwt`: Use JSON Web Tokens to authenticate the client.\n`none`: Used for public clients (native apps, mobile apps) which can not have secrets.", "type": "string" }, "token_endpoint_auth_signing_alg": { "description": "OAuth 2.0 Token Endpoint Signing Algorithm\n\nRequested Client Authentication signing algorithm for the Token Endpoint.", "type": "string" }, "tos_uri": { "description": "OAuth 2.0 Client Terms of Service URI\n\nA URL string pointing to a human-readable terms of service\ndocument for the client that describes a contractual relationship\nbetween the end-user and the client that the end-user accepts when\nauthorizing the client.", "type": "string" }, "updated_at": { "description": "OAuth 2.0 Client Last Update Date\n\nUpdatedAt returns the timestamp of the last update.", "format": "date-time", "type": "string" }, "userinfo_signed_response_alg": { "description": "OpenID Connect Request Userinfo Signed Response Algorithm\n\nJWS alg algorithm [JWA] REQUIRED for signing UserInfo Responses. If this is specified, the response will be JWT\n[JWT] serialized, and signed using JWS. The default, if omitted, is for the UserInfo Response to return the Claims\nas a UTF-8 encoded JSON object using the application/json content-type.", "type": "string" } }, "title": "OAuth 2.0 Client", "type": "object" }, "oAuth2ClientTokenLifespans": { "description": "Lifespans of different token types issued for this OAuth 2.0 Client.", "properties": { "authorization_code_grant_access_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "authorization_code_grant_id_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "authorization_code_grant_refresh_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "client_credentials_grant_access_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "device_authorization_grant_access_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "device_authorization_grant_id_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "device_authorization_grant_refresh_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "implicit_grant_access_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "implicit_grant_id_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "jwt_bearer_grant_access_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "refresh_token_grant_access_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "refresh_token_grant_id_token_lifespan": { "$ref": "#/components/schemas/NullDuration" }, "refresh_token_grant_refresh_token_lifespan": { "$ref": "#/components/schemas/NullDuration" } }, "title": "OAuth 2.0 Client Token Lifespans", "type": "object" }, "oAuth2ConsentRequest": { "properties": { "acr": { "description": "ACR represents the Authentication AuthorizationContext Class Reference value for this authentication session. You can use it\nto express that, for example, a user authenticated using two factor authentication.", "type": "string" }, "amr": { "description": "AMR is the Authentication Methods References value for this\nauthentication session. You can use it to specify the method a user used to\nauthenticate. For example, if the acr indicates a user used two factor\nauthentication, the amr can express they used a software-secured key.", "items": { "type": "string" }, "type": "array" }, "challenge": { "description": "Challenge is used to retrieve/accept/deny the consent request.", "type": "string" }, "client": { "$ref": "#/components/schemas/oAuth2Client" }, "consent_request_id": { "description": "ConsentRequestID is the ID of the consent request.", "type": "string" }, "context": { "$ref": "#/components/schemas/JSONRawMessage" }, "login_challenge": { "description": "LoginChallenge is the login challenge this consent challenge belongs to. It can be used to associate\na login and consent request in the login \u0026 consent app.", "type": "string" }, "login_session_id": { "description": "LoginSessionID is the login session ID. If the user-agent reuses a login session (via cookie / remember flag)\nthis ID will remain the same. If the user-agent did not have an existing authentication session (e.g. remember is false)\nthis will be a new random value. This value is used as the \"sid\" parameter in the ID Token and in OIDC Front-/Back-\nchannel logout. It's value can generally be used to associate consecutive login requests by a certain user.", "type": "string" }, "oidc_context": { "$ref": "#/components/schemas/oAuth2ConsentRequestOpenIDConnectContext" }, "request_url": { "description": "RequestURL is the original OAuth 2.0 Authorization URL requested by the OAuth 2.0 client. It is the URL which\ninitiates the OAuth 2.0 Authorization Code or OAuth 2.0 Implicit flow. This URL is typically not needed, but\nmight come in handy if you want to deal with additional request parameters.", "type": "string" }, "requested_access_token_audience": { "description": "RequestedAudience contains the access token audience as requested by the OAuth 2.0 Client.", "items": { "type": "string" }, "type": "array" }, "requested_scope": { "description": "RequestedScope contains the OAuth 2.0 Scope requested by the OAuth 2.0 Client.", "items": { "type": "string" }, "type": "array" }, "skip": { "description": "Skip, if true, implies that the client has requested the same scopes from the same user previously.\nIf true, you must not ask the user to grant the requested scopes. You must however either allow or deny the\nconsent request using the usual API call.", "type": "boolean" }, "subject": { "description": "Subject is the user ID of the end-user that authenticated. Now, that end user needs to grant or deny the scope\nrequested by the OAuth 2.0 client.", "type": "string" } }, "required": [ "challenge" ], "title": "Contains information on an ongoing consent request.", "type": "object" }, "oAuth2ConsentRequestOpenIDConnectContext": { "properties": { "acr_values": { "description": "ACRValues is the Authentication AuthorizationContext Class Reference requested in the OAuth 2.0 Authorization request.\nIt is a parameter defined by OpenID Connect and expresses which level of authentication (e.g. 2FA) is required.\n\nOpenID Connect defines it as follows:\n\u003e Requested Authentication AuthorizationContext Class Reference values. Space-separated string that specifies the acr values\nthat the Authorization Server is being requested to use for processing this Authentication Request, with the\nvalues appearing in order of preference. The Authentication AuthorizationContext Class satisfied by the authentication\nperformed is returned as the acr Claim Value, as specified in Section 2. The acr Claim is requested as a\nVoluntary Claim by this parameter.", "items": { "type": "string" }, "type": "array" }, "display": { "description": "Display is a string value that specifies how the Authorization Server displays the authentication and consent user interface pages to the End-User.\nThe defined values are:\npage: The Authorization Server SHOULD display the authentication and consent UI consistent with a full User Agent page view. If the display parameter is not specified, this is the default display mode.\npopup: The Authorization Server SHOULD display the authentication and consent UI consistent with a popup User Agent window. The popup User Agent window should be of an appropriate size for a login-focused dialog and should not obscure the entire window that it is popping up over.\ntouch: The Authorization Server SHOULD display the authentication and consent UI consistent with a device that leverages a touch interface.\nwap: The Authorization Server SHOULD display the authentication and consent UI consistent with a \"feature phone\" type display.\n\nThe Authorization Server MAY also attempt to detect the capabilities of the User Agent and present an appropriate display.", "type": "string" }, "id_token_hint_claims": { "additionalProperties": {}, "description": "IDTokenHintClaims are the claims of the ID Token previously issued by the Authorization Server being passed as a hint about the\nEnd-User's current or past authenticated session with the Client.", "type": "object" }, "login_hint": { "description": "LoginHint hints about the login identifier the End-User might use to log in (if necessary).\nThis hint can be used by an RP if it first asks the End-User for their e-mail address (or other identifier)\nand then wants to pass that value as a hint to the discovered authorization service. This value MAY also be a\nphone number in the format specified for the phone_number Claim. The use of this parameter is optional.", "type": "string" }, "ui_locales": { "description": "UILocales is the End-User'id preferred languages and scripts for the user interface, represented as a\nspace-separated list of BCP47 [RFC5646] language tag values, ordered by preference. For instance, the value\n\"fr-CA fr en\" represents a preference for French as spoken in Canada, then French (without a region designation),\nfollowed by English (without a region designation). An error SHOULD NOT result if some or all of the requested\nlocales are not supported by the OpenID Provider.", "items": { "type": "string" }, "type": "array" } }, "title": "Contains optional information about the OpenID Connect request.", "type": "object" }, "oAuth2ConsentSession": { "description": "A completed OAuth 2.0 Consent Session.", "properties": { "consent_request": { "$ref": "#/components/schemas/oAuth2ConsentRequest" }, "consent_request_id": { "description": "ConsentRequestID is the identifier of the consent request that initiated this consent session.", "type": "string" }, "context": { "$ref": "#/components/schemas/JSONRawMessage" }, "grant_access_token_audience": { "description": "Audience Granted\n\nGrantedAudience sets the audience the user authorized the client to use. Should be a subset of `requested_access_token_audience`.", "items": { "type": "string" }, "type": "array" }, "grant_scope": { "description": "Scope Granted\n\nGrantScope sets the scope the user authorized the client to use. Should be a subset of `requested_scope`.", "items": { "type": "string" }, "type": "array" }, "handled_at": { "$ref": "#/components/schemas/nullTime" }, "remember": { "description": "Remember Consent\n\nRemember, if set to true, tells ORY Hydra to remember this consent authorization and reuse it if the same\nclient asks the same user for the same, or a subset of, scope.", "type": "boolean" }, "remember_for": { "description": "Remember Consent For\n\nRememberFor sets how long the consent authorization should be remembered for in seconds. If set to `0`, the\nauthorization will be remembered indefinitely.", "format": "int64", "type": "integer" }, "session": { "$ref": "#/components/schemas/acceptOAuth2ConsentRequestSession" } }, "title": "OAuth 2.0 Consent Session", "type": "object" }, "oAuth2ConsentSessions": { "description": "List of OAuth 2.0 Consent Sessions", "items": { "$ref": "#/components/schemas/oAuth2ConsentSession" }, "type": "array" }, "oAuth2LoginRequest": { "properties": { "challenge": { "description": "ID is the identifier of the login request.", "type": "string" }, "client": { "$ref": "#/components/schemas/oAuth2Client" }, "oidc_context": { "$ref": "#/components/schemas/oAuth2ConsentRequestOpenIDConnectContext" }, "request_url": { "description": "RequestURL is the original OAuth 2.0 Authorization URL requested by the OAuth 2.0 client. It is the URL which\ninitiates the OAuth 2.0 Authorization Code or OAuth 2.0 Implicit flow. This URL is typically not needed, but\nmight come in handy if you want to deal with additional request parameters.", "type": "string" }, "requested_access_token_audience": { "description": "RequestedAudience contains the access token audience as requested by the OAuth 2.0 Client.", "items": { "type": "string" }, "type": "array" }, "requested_scope": { "description": "RequestedScope contains the OAuth 2.0 Scope requested by the OAuth 2.0 Client.", "items": { "type": "string" }, "type": "array" }, "session_id": { "description": "SessionID is the login session ID. If the user-agent reuses a login session (via cookie / remember flag)\nthis ID will remain the same. If the user-agent did not have an existing authentication session (e.g. remember is false)\nthis will be a new random value. This value is used as the \"sid\" parameter in the ID Token and in OIDC Front-/Back-\nchannel logout. It's value can generally be used to associate consecutive login requests by a certain user.", "type": "string" }, "skip": { "description": "Skip, if true, implies that the client has requested the same scopes from the same user previously.\nIf true, you can skip asking the user to grant the requested scopes, and simply forward the user to the redirect URL.\n\nThis feature allows you to update / set session information.", "type": "boolean" }, "subject": { "description": "Subject is the user ID of the end-user that authenticated. Now, that end user needs to grant or deny the scope\nrequested by the OAuth 2.0 client. If this value is set and `skip` is true, you MUST include this subject type\nwhen accepting the login request, or the request will fail.", "type": "string" } }, "required": [ "challenge", "skip", "subject", "client", "request_url" ], "title": "Contains information on an ongoing login request.", "type": "object" }, "oAuth2LogoutRequest": { "properties": { "challenge": { "description": "Challenge is used to retrieve/accept/deny the logout request.", "type": "string" }, "client": { "$ref": "#/components/schemas/oAuth2Client" }, "expires_at": { "format": "date-time", "type": "string" }, "request_url": { "description": "RequestURL is the original Logout URL requested.", "type": "string" }, "requested_at": { "format": "date-time", "type": "string" }, "rp_initiated": { "description": "RPInitiated is set to true if the request was initiated by a Relying Party (RP), also known as an OAuth 2.0 Client.", "type": "boolean" }, "sid": { "description": "SessionID is the login session ID that was requested to log out.", "type": "string" }, "subject": { "description": "Subject is the user for whom the logout was requested.", "type": "string" } }, "title": "Contains information about an ongoing logout request.", "type": "object" }, "oAuth2RedirectTo": { "description": "Contains a redirect URL used to complete a login, consent, or logout request.", "properties": { "redirect_to": { "description": "RedirectURL is the URL which you should redirect the user's browser to once the authentication process is completed.", "type": "string" } }, "required": [ "redirect_to" ], "title": "OAuth 2.0 Redirect Browser To", "type": "object" }, "oAuth2TokenExchange": { "description": "OAuth2 Token Exchange Result", "properties": { "access_token": { "description": "The access token issued by the authorization server.", "type": "string" }, "expires_in": { "description": "The lifetime in seconds of the access token. For\nexample, the value \"3600\" denotes that the access token will\nexpire in one hour from the time the response was generated.", "format": "int64", "type": "integer" }, "id_token": { "description": "To retrieve a refresh token request the id_token scope.", "type": "string" }, "refresh_token": { "description": "The refresh token, which can be used to obtain new\naccess tokens. To retrieve it add the scope \"offline\" to your access token request.", "type": "string" }, "scope": { "description": "The scope of the access token", "type": "string" }, "token_type": { "description": "The type of the token issued", "type": "string" } }, "type": "object" }, "oidcConfiguration": { "description": "Includes links to several endpoints (for example `/oauth2/token`) and exposes information on supported signature algorithms\namong others.", "properties": { "authorization_endpoint": { "description": "OAuth 2.0 Authorization Endpoint URL", "example": "https://playground.ory.sh/ory-hydra/public/oauth2/auth", "type": "string" }, "backchannel_logout_session_supported": { "description": "OpenID Connect Back-Channel Logout Session Required\n\nBoolean value specifying whether the OP can pass a sid (session ID) Claim in the Logout Token to identify the RP\nsession with the OP. If supported, the sid Claim is also included in ID Tokens issued by the OP", "type": "boolean" }, "backchannel_logout_supported": { "description": "OpenID Connect Back-Channel Logout Supported\n\nBoolean value specifying whether the OP supports back-channel logout, with true indicating support.", "type": "boolean" }, "claims_parameter_supported": { "description": "OpenID Connect Claims Parameter Parameter Supported\n\nBoolean value specifying whether the OP supports use of the claims parameter, with true indicating support.", "type": "boolean" }, "claims_supported": { "description": "OpenID Connect Supported Claims\n\nJSON array containing a list of the Claim Names of the Claims that the OpenID Provider MAY be able to supply\nvalues for. Note that for privacy or other reasons, this might not be an exhaustive list.", "items": { "type": "string" }, "type": "array" }, "code_challenge_methods_supported": { "description": "OAuth 2.0 PKCE Supported Code Challenge Methods\n\nJSON array containing a list of Proof Key for Code Exchange (PKCE) [RFC7636] code challenge methods supported\nby this authorization server.", "items": { "type": "string" }, "type": "array" }, "credentials_endpoint_draft_00": { "description": "OpenID Connect Verifiable Credentials Endpoint\n\nContains the URL of the Verifiable Credentials Endpoint.", "type": "string" }, "credentials_supported_draft_00": { "description": "OpenID Connect Verifiable Credentials Supported\n\nJSON array containing a list of the Verifiable Credentials supported by this authorization server.", "items": { "$ref": "#/components/schemas/credentialSupportedDraft00" }, "type": "array" }, "device_authorization_endpoint": { "description": "OAuth 2.0 Device Authorization Endpoint URL", "example": "https://playground.ory.sh/ory-hydra/public/oauth2/device/oauth", "type": "string" }, "end_session_endpoint": { "description": "OpenID Connect End-Session Endpoint\n\nURL at the OP to which an RP can perform a redirect to request that the End-User be logged out at the OP.", "type": "string" }, "frontchannel_logout_session_supported": { "description": "OpenID Connect Front-Channel Logout Session Required\n\nBoolean value specifying whether the OP can pass iss (issuer) and sid (session ID) query parameters to identify\nthe RP session with the OP when the frontchannel_logout_uri is used. If supported, the sid Claim is also\nincluded in ID Tokens issued by the OP.", "type": "boolean" }, "frontchannel_logout_supported": { "description": "OpenID Connect Front-Channel Logout Supported\n\nBoolean value specifying whether the OP supports HTTP-based logout, with true indicating support.", "type": "boolean" }, "grant_types_supported": { "description": "OAuth 2.0 Supported Grant Types\n\nJSON array containing a list of the OAuth 2.0 Grant Type values that this OP supports.", "items": { "type": "string" }, "type": "array" }, "id_token_signed_response_alg": { "description": "OpenID Connect Default ID Token Signing Algorithms\n\nAlgorithm used to sign OpenID Connect ID Tokens.", "items": { "type": "string" }, "type": "array" }, "id_token_signing_alg_values_supported": { "description": "OpenID Connect Supported ID Token Signing Algorithms\n\nJSON array containing a list of the JWS signing algorithms (alg values) supported by the OP for the ID Token\nto encode the Claims in a JWT.", "items": { "type": "string" }, "type": "array" }, "issuer": { "description": "OpenID Connect Issuer URL\n\nAn URL using the https scheme with no query or fragment component that the OP asserts as its IssuerURL Identifier.\nIf IssuerURL discovery is supported , this value MUST be identical to the issuer value returned\nby WebFinger. This also MUST be identical to the iss Claim value in ID Tokens issued from this IssuerURL.", "example": "https://playground.ory.sh/ory-hydra/public/", "type": "string" }, "jwks_uri": { "description": "OpenID Connect Well-Known JSON Web Keys URL\n\nURL of the OP's JSON Web Key Set [JWK] document. This contains the signing key(s) the RP uses to validate\nsignatures from the OP. The JWK Set MAY also contain the Server's encryption key(s), which are used by RPs\nto encrypt requests to the Server. When both signing and encryption keys are made available, a use (Key Use)\nparameter value is REQUIRED for all keys in the referenced JWK Set to indicate each key's intended usage.\nAlthough some algorithms allow the same key to be used for both signatures and encryption, doing so is\nNOT RECOMMENDED, as it is less secure. The JWK x5c parameter MAY be used to provide X.509 representations of\nkeys provided. When used, the bare key values MUST still be present and MUST match those in the certificate.", "example": "https://{slug}.projects.oryapis.com/.well-known/jwks.json", "type": "string" }, "registration_endpoint": { "description": "OpenID Connect Dynamic Client Registration Endpoint URL", "example": "https://playground.ory.sh/ory-hydra/admin/client", "type": "string" }, "request_object_signing_alg_values_supported": { "description": "OpenID Connect Supported Request Object Signing Algorithms\n\nJSON array containing a list of the JWS signing algorithms (alg values) supported by the OP for Request Objects,\nwhich are described in Section 6.1 of OpenID Connect Core 1.0 [OpenID.Core]. These algorithms are used both when\nthe Request Object is passed by value (using the request parameter) and when it is passed by reference\n(using the request_uri parameter).", "items": { "type": "string" }, "type": "array" }, "request_parameter_supported": { "description": "OpenID Connect Request Parameter Supported\n\nBoolean value specifying whether the OP supports use of the request parameter, with true indicating support.", "type": "boolean" }, "request_uri_parameter_supported": { "description": "OpenID Connect Request URI Parameter Supported\n\nBoolean value specifying whether the OP supports use of the request_uri parameter, with true indicating support.", "type": "boolean" }, "require_request_uri_registration": { "description": "OpenID Connect Requires Request URI Registration\n\nBoolean value specifying whether the OP requires any request_uri values used to be pre-registered\nusing the request_uris registration parameter.", "type": "boolean" }, "response_modes_supported": { "description": "OAuth 2.0 Supported Response Modes\n\nJSON array containing a list of the OAuth 2.0 response_mode values that this OP supports.", "items": { "type": "string" }, "type": "array" }, "response_types_supported": { "description": "OAuth 2.0 Supported Response Types\n\nJSON array containing a list of the OAuth 2.0 response_type values that this OP supports. Dynamic OpenID\nProviders MUST support the code, id_token, and the token id_token Response Type values.", "items": { "type": "string" }, "type": "array" }, "revocation_endpoint": { "description": "OAuth 2.0 Token Revocation URL\n\nURL of the authorization server's OAuth 2.0 revocation endpoint.", "type": "string" }, "scopes_supported": { "description": "OAuth 2.0 Supported Scope Values\n\nJSON array containing a list of the OAuth 2.0 [RFC6749] scope values that this server supports. The server MUST\nsupport the openid scope value. Servers MAY choose not to advertise some supported scope values even when this parameter is used", "items": { "type": "string" }, "type": "array" }, "subject_types_supported": { "description": "OpenID Connect Supported Subject Types\n\nJSON array containing a list of the Subject Identifier types that this OP supports. Valid types include\npairwise and public.", "items": { "type": "string" }, "type": "array" }, "token_endpoint": { "description": "OAuth 2.0 Token Endpoint URL", "example": "https://playground.ory.sh/ory-hydra/public/oauth2/token", "type": "string" }, "token_endpoint_auth_methods_supported": { "description": "OAuth 2.0 Supported Client Authentication Methods\n\nJSON array containing a list of Client Authentication methods supported by this Token Endpoint. The options are\nclient_secret_post, client_secret_basic, client_secret_jwt, and private_key_jwt, as described in Section 9 of OpenID Connect Core 1.0", "items": { "type": "string" }, "type": "array" }, "userinfo_endpoint": { "description": "OpenID Connect Userinfo URL\n\nURL of the OP's UserInfo Endpoint.", "type": "string" }, "userinfo_signed_response_alg": { "description": "OpenID Connect User Userinfo Signing Algorithm\n\nAlgorithm used to sign OpenID Connect Userinfo Responses.", "items": { "type": "string" }, "type": "array" }, "userinfo_signing_alg_values_supported": { "description": "OpenID Connect Supported Userinfo Signing Algorithm\n\nJSON array containing a list of the JWS [JWS] signing algorithms (alg values) [JWA] supported by the UserInfo Endpoint to encode the Claims in a JWT [JWT].", "items": { "type": "string" }, "type": "array" } }, "required": [ "issuer", "authorization_endpoint", "device_authorization_endpoint", "token_endpoint", "jwks_uri", "subject_types_supported", "response_types_supported", "id_token_signing_alg_values_supported", "id_token_signed_response_alg", "userinfo_signed_response_alg" ], "title": "OpenID Connect Discovery Metadata", "type": "object" }, "oidcUserInfo": { "description": "OpenID Connect Userinfo", "properties": { "birthdate": { "description": "End-User's birthday, represented as an ISO 8601:2004 [ISO8601‑2004] YYYY-MM-DD format. The year MAY be 0000, indicating that it is omitted. To represent only the year, YYYY format is allowed. Note that depending on the underlying platform's date related function, providing just year can result in varying month and day, so the implementers need to take this factor into account to correctly process the dates.", "type": "string" }, "email": { "description": "End-User's preferred e-mail address. Its value MUST conform to the RFC 5322 [RFC5322] addr-spec syntax. The RP MUST NOT rely upon this value being unique, as discussed in Section 5.7.", "type": "string" }, "email_verified": { "description": "True if the End-User's e-mail address has been verified; otherwise false. When this Claim Value is true, this means that the OP took affirmative steps to ensure that this e-mail address was controlled by the End-User at the time the verification was performed. The means by which an e-mail address is verified is context-specific, and dependent upon the trust framework or contractual agreements within which the parties are operating.", "type": "boolean" }, "family_name": { "description": "Surname(s) or last name(s) of the End-User. Note that in some cultures, people can have multiple family names or no family name; all can be present, with the names being separated by space characters.", "type": "string" }, "gender": { "description": "End-User's gender. Values defined by this specification are female and male. Other values MAY be used when neither of the defined values are applicable.", "type": "string" }, "given_name": { "description": "Given name(s) or first name(s) of the End-User. Note that in some cultures, people can have multiple given names; all can be present, with the names being separated by space characters.", "type": "string" }, "locale": { "description": "End-User's locale, represented as a BCP47 [RFC5646] language tag. This is typically an ISO 639-1 Alpha-2 [ISO639‑1] language code in lowercase and an ISO 3166-1 Alpha-2 [ISO3166‑1] country code in uppercase, separated by a dash. For example, en-US or fr-CA. As a compatibility note, some implementations have used an underscore as the separator rather than a dash, for example, en_US; Relying Parties MAY choose to accept this locale syntax as well.", "type": "string" }, "middle_name": { "description": "Middle name(s) of the End-User. Note that in some cultures, people can have multiple middle names; all can be present, with the names being separated by space characters. Also note that in some cultures, middle names are not used.", "type": "string" }, "name": { "description": "End-User's full name in displayable form including all name parts, possibly including titles and suffixes, ordered according to the End-User's locale and preferences.", "type": "string" }, "nickname": { "description": "Casual name of the End-User that may or may not be the same as the given_name. For instance, a nickname value of Mike might be returned alongside a given_name value of Michael.", "type": "string" }, "phone_number": { "description": "End-User's preferred telephone number. E.164 [E.164] is RECOMMENDED as the format of this Claim, for example, +1 (425) 555-1212 or +56 (2) 687 2400. If the phone number contains an extension, it is RECOMMENDED that the extension be represented using the RFC 3966 [RFC3966] extension syntax, for example, +1 (604) 555-1234;ext=5678.", "type": "string" }, "phone_number_verified": { "description": "True if the End-User's phone number has been verified; otherwise false. When this Claim Value is true, this means that the OP took affirmative steps to ensure that this phone number was controlled by the End-User at the time the verification was performed. The means by which a phone number is verified is context-specific, and dependent upon the trust framework or contractual agreements within which the parties are operating. When true, the phone_number Claim MUST be in E.164 format and any extensions MUST be represented in RFC 3966 format.", "type": "boolean" }, "picture": { "description": "URL of the End-User's profile picture. This URL MUST refer to an image file (for example, a PNG, JPEG, or GIF image file), rather than to a Web page containing an image. Note that this URL SHOULD specifically reference a profile photo of the End-User suitable for displaying when describing the End-User, rather than an arbitrary photo taken by the End-User.", "type": "string" }, "preferred_username": { "description": "Non-unique shorthand name by which the End-User wishes to be referred to at the RP, such as janedoe or j.doe. This value MAY be any valid JSON string including special characters such as @, /, or whitespace.", "type": "string" }, "profile": { "description": "URL of the End-User's profile page. The contents of this Web page SHOULD be about the End-User.", "type": "string" }, "sub": { "description": "Subject - Identifier for the End-User at the IssuerURL.", "type": "string" }, "updated_at": { "description": "Time the End-User's information was last updated. Its value is a JSON number representing the number of seconds from 1970-01-01T0:0:0Z as measured in UTC until the date/time.", "format": "int64", "type": "integer" }, "website": { "description": "URL of the End-User's Web page or blog. This Web page SHOULD contain information published by the End-User or an organization that the End-User is affiliated with.", "type": "string" }, "zoneinfo": { "description": "String from zoneinfo [zoneinfo] time zone database representing the End-User's time zone. For example, Europe/Paris or America/Los_Angeles.", "type": "string" } }, "type": "object" }, "onboardingPortalLink": { "properties": { "apple_mapper_url": { "description": "AppleMapper specifies the JSONNet code snippet which uses Apple's\nprofile information to hydrate the identity's data.", "type": "string" }, "auth0_mapper_url": { "description": "Auth0Mapper specifies the JSONNet code snippet which uses Auth0's\nprofile information to hydrate the identity's data.", "type": "string" }, "created_at": { "description": "The onboarding portal link's creation date", "format": "date-time", "readOnly": true, "type": "string" }, "custom_hostname_id": { "$ref": "#/components/schemas/NullUUID" }, "enable_scim": { "description": "Feature flag to enable SCIM configuration", "type": "boolean" }, "enable_sso": { "description": "Feature flag to enable SSO configuration", "type": "boolean" }, "expires_at": { "description": "The onboarding portal link's expiry date", "format": "date-time", "readOnly": true, "type": "string" }, "facebook_mapper_url": { "description": "FacebookMapper specifies the JSONNet code snippet which uses Facebook's\nprofile information to hydrate the identity's data.", "type": "string" }, "generic_oidc_mapper_url": { "description": "GenericOIDCMapper specifies the JSONNet code snippet which uses the OIDC Provider's\nprofile information to hydrate the identity's data.", "type": "string" }, "github_mapper_url": { "description": "GithubMapper specifies the JSONNet code snippet which uses GitHub's\nprofile information to hydrate the identity's data.", "type": "string" }, "gitlab_mapper_url": { "description": "GitLabMapper specifies the JSONNet code snippet which uses GitLab's\nprofile information to hydrate the identity's data.", "type": "string" }, "google_mapper_url": { "description": "GoogleMapper specifies the JSONNet code snippet which uses Google's\nprofile information to hydrate the identity's data.", "type": "string" }, "id": { "description": "The onboarding portal link's ID.", "format": "uuid", "readOnly": true, "type": "string" }, "microsoft_mapper_url": { "description": "MicrosoftMapper specifies the JSONNet code snippet which uses Microsoft's\nprofile information to hydrate the identity's data.", "type": "string" }, "netid_mapper_url": { "description": "NetIDMapper specifies the JSONNet code snippet which uses NetID's\nprofile information to hydrate the identity's data.", "type": "string" }, "organization_id": { "description": "The onboarding portal link's organization ID", "format": "uuid", "readOnly": true, "type": "string" }, "project_id": { "description": "The onboarding portal link's project ID", "format": "uuid", "readOnly": true, "type": "string" }, "proxy_acs_url": { "description": "Proxy ACS URL if overriding with a customer-controlled URL", "type": "string" }, "proxy_oidc_redirect_url": { "description": "Proxy OIDC Redirect URL if overriding with a customer-controlled URL", "type": "string" }, "proxy_saml_audience_override": { "description": "SAML Audience Override if overriding with a customer-controlled one", "type": "string" }, "proxy_scim_server_url": { "description": "Proxy SCIM Server URL if overriding with a customer-controlled URL", "type": "string" }, "saml_mapper_url": { "description": "SAMLMapper specifies the JSONNet code snippet which uses the SAML Provider's\nprofile information to hydrate the identity's data.", "type": "string" }, "scim_mapper_url": { "description": "SCIMMapper specifies the JSONNet code snippet which uses the SCIM Provider's\nprofile information to hydrate the identity's data.", "type": "string" }, "value": { "description": "The onboarding portal link's value", "readOnly": true, "type": "string" } }, "required": [ "id", "value", "project_id", "organization_id", "expires_at" ], "type": "object" }, "onboardingPortalOrganization": { "properties": { "apple_mapper_url": { "description": "AppleMapper specifies the JSONNet code snippet which uses Apple's\nprofile information to hydrate the identity's data.", "type": "string" }, "auth0_mapper_url": { "description": "Auth0Mapper specifies the JSONNet code snippet which uses Auth0's\nprofile information to hydrate the identity's data.", "type": "string" }, "base_url": { "type": "string" }, "facebook_mapper_url": { "description": "FacebookMapper specifies the JSONNet code snippet which uses Facebook's\nprofile information to hydrate the identity's data.", "type": "string" }, "generic_oidc_mapper_url": { "description": "GenericOIDCMapper specifies the JSONNet code snippet which uses the OIDC Provider's\nprofile information to hydrate the identity's data.", "type": "string" }, "github_mapper_url": { "description": "GithubMapper specifies the JSONNet code snippet which uses GitHub's\nprofile information to hydrate the identity's data.", "type": "string" }, "gitlab_mapper_url": { "description": "GitLabMapper specifies the JSONNet code snippet which uses GitLab's\nprofile information to hydrate the identity's data.", "type": "string" }, "google_mapper_url": { "description": "GoogleMapper specifies the JSONNet code snippet which uses Google's\nprofile information to hydrate the identity's data.", "type": "string" }, "kratos_selfservice_methods_oidc_config_providers": { "$ref": "#/components/schemas/projectRevisionThirdPartyLoginProviders" }, "kratos_selfservice_methods_saml_config_providers": { "$ref": "#/components/schemas/projectRevisionSamlProviders" }, "microsoft_mapper_url": { "description": "MicrosoftMapper specifies the JSONNet code snippet which uses Microsoft's\nprofile information to hydrate the identity's data.", "type": "string" }, "netid_mapper_url": { "description": "NetIDMapper specifies the JSONNet code snippet which uses NetID's\nprofile information to hydrate the identity's data.", "type": "string" }, "oidc_sso_enabled": { "type": "boolean" }, "organization_id": { "format": "uuid", "type": "string" }, "organization_label": { "description": "Organization Label", "type": "string" }, "proxy_acs_url": { "description": "Proxy ACS URL if overriding with a customer-controlled URL", "type": "string" }, "proxy_oidc_redirect_url": { "description": "Proxy OIDC Redirect URL if overriding with a customer-controlled URL", "type": "string" }, "proxy_saml_audience_override": { "description": "SAML Audience Override if overriding with a customer-controlled one", "type": "string" }, "proxy_scim_server_url": { "description": "Proxy SCIM Server URL if overriding with a customer-controlled URL", "type": "string" }, "revision_id": { "format": "uuid", "type": "string" }, "saml_mapper_url": { "description": "SAMLMapper specifies the JSONNet code snippet which uses the SAML Provider's\nprofile information to hydrate the identity's data.", "type": "string" }, "saml_sso_enabled": { "type": "boolean" }, "scim_clients": { "$ref": "#/components/schemas/projectRevisionScimClients" }, "scim_enabled": { "type": "boolean" }, "scim_mapper_url": { "description": "SCIMMapper specifies the JSONNet code snippet which uses the SCIM Provider's\nprofile information to hydrate the identity's data.", "type": "string" }, "sso_enabled": { "type": "boolean" } }, "required": [ "revision_id", "base_url", "sso_enabled", "scim_enabled", "kratos_selfservice_methods_saml_config_providers", "kratos_selfservice_methods_oidc_config_providers", "scim_clients", "organization_id" ], "type": "object" }, "onboardingPortalTestLoginFlow": { "description": "Response body for a dry-run OIDC test login flow created from an onboarding\nportal link. Only the flow ID is part of the API contract.", "properties": { "id": { "description": "ID of the created test login flow. Append this as the `flow` query\nparameter on the test sign-in UI URL.", "type": "string" } }, "required": [ "id" ], "type": "object" }, "organization": { "description": "B2B SSO Organization", "properties": { "created_at": { "format": "date-time", "type": "string" }, "default_region": { "description": "DefaultRegion sets the default region for identities provisioned into\nthis organization, when the identity does not specify a region explictly.\neu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global", "enum": [ "eu-central", "asia-northeast", "us-east", "us-west", "eu", "asia", "us", "global" ], "type": "string", "x-go-enum-desc": "eu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global" }, "domains": { "description": "The list of organization's domains.", "items": { "type": "string" }, "type": "array" }, "id": { "description": "The organization's ID.", "format": "uuid", "type": "string" }, "label": { "description": "The organization's human-readable label.", "type": "string" }, "session_lifespan": { "description": "SessionLifespan overrides the project-level session lifespan for sessions\nissued for this organization. A Go duration string between 1m and 8760h.\nA null (or zero) value means the project default applies.", "example": "24h", "pattern": "^[0-9]+(s|m|h)$", "type": "string" } }, "required": [ "id", "label", "domains", "created_at" ], "type": "object" }, "organizationByHostname": { "properties": { "domains": { "description": "Domains are the organization's SSO domains.", "items": { "type": "string" }, "type": "array" }, "id": { "description": "ID is the organization's unique identifier.", "type": "string" } }, "required": [ "id", "domains" ], "title": "organizationByHostname is a single B2B SSO organization.", "type": "object" }, "organizationOnboardingPortalLinksResponse": { "properties": { "links": { "items": { "$ref": "#/components/schemas/onboardingPortalLink" }, "type": "array" } }, "required": [ "links" ], "type": "object" }, "organizations": { "items": { "$ref": "#/components/schemas/organization" }, "type": "array" }, "patchIdentitiesBody": { "description": "Patch Identities Body", "properties": { "identities": { "description": "Identities holds the list of patches to apply\n\nrequired", "items": { "$ref": "#/components/schemas/identityPatch" }, "type": "array" } }, "type": "object" }, "performNativeLogoutBody": { "description": "Perform Native Logout Request Body", "properties": { "session_token": { "description": "The Session Token\n\nInvalidate this session token.", "type": "string" } }, "required": [ "session_token" ], "type": "object" }, "permissionsOnProject": { "additionalProperties": { "type": "boolean" }, "description": "Get Permissions on Project Request Parameters", "type": "object" }, "permissionsOnWorkspace": { "description": "Get Permissions on Project Request Parameters", "properties": { "permissions": { "additionalProperties": { "type": "boolean" }, "type": "object" } }, "type": "object" }, "plans": { "$ref": "#/components/schemas/Pricing" }, "postCheckPermissionBody": { "description": "Check Permission using Post Request Body", "properties": { "namespace": { "description": "Namespace to query", "type": "string" }, "object": { "description": "Object to query", "type": "string" }, "relation": { "description": "Relation to query", "type": "string" }, "subject_id": { "description": "SubjectID to query\n\nEither SubjectSet or SubjectID can be provided.", "type": "string" }, "subject_set": { "$ref": "#/components/schemas/subjectSet" } }, "type": "object" }, "postCheckPermissionOrErrorBody": { "description": "Post Check Permission Or Error Body", "properties": { "namespace": { "description": "Namespace to query", "type": "string" }, "object": { "description": "Object to query", "type": "string" }, "relation": { "description": "Relation to query", "type": "string" }, "subject_id": { "description": "SubjectID to query\n\nEither SubjectSet or SubjectID can be provided.", "type": "string" }, "subject_set": { "$ref": "#/components/schemas/subjectSet" } }, "type": "object" }, "project": { "properties": { "cors_admin": { "$ref": "#/components/schemas/projectCors" }, "cors_public": { "$ref": "#/components/schemas/projectCors" }, "environment": { "description": "The environment of the project.\nprod Production\nstage Staging\ndev Development", "enum": [ "prod", "stage", "dev" ], "type": "string", "x-go-enum-desc": "prod Production\nstage Staging\ndev Development" }, "home_region": { "description": "The project home region.\n\nThis is used to set where the project data is stored and where the project's endpoints are located.\neu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global", "enum": [ "eu-central", "asia-northeast", "us-east", "us-west", "eu", "asia", "us", "global" ], "type": "string", "x-go-enum-desc": "eu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global" }, "id": { "description": "The project's ID.", "format": "uuid", "readOnly": true, "type": "string" }, "name": { "description": "The name of the project.", "type": "string" }, "organizations": { "description": "The organizations of the project.\n\nOrganizations are used to group users and enforce certain restrictions like usage of SSO.", "items": { "$ref": "#/components/schemas/basicOrganization" }, "type": "array" }, "revision_id": { "description": "The configuration revision ID.", "format": "uuid", "readOnly": true, "type": "string" }, "services": { "$ref": "#/components/schemas/projectServices" }, "slug": { "description": "The project's slug", "readOnly": true, "type": "string" }, "state": { "description": "The state of the project.\nrunning Running\nhalted Halted\ndeleted Deleted", "enum": [ "running", "halted", "deleted" ], "readOnly": true, "type": "string", "x-go-enum-desc": "running Running\nhalted Halted\ndeleted Deleted" }, "workspace_id": { "$ref": "#/components/schemas/NullUUID" } }, "required": [ "id", "revision_id", "slug", "services", "state", "name", "environment", "home_region", "organizations" ], "type": "object" }, "projectApiKey": { "properties": { "created_at": { "description": "The token's creation date", "format": "date-time", "readOnly": true, "type": "string" }, "expires_at": { "$ref": "#/components/schemas/Time" }, "id": { "description": "The token's ID.", "format": "uuid", "readOnly": true, "type": "string" }, "last_characters": { "description": "The last characters of the token's value.\n\nLets you tell API keys apart in the UI without revealing the full\nvalue. Empty for keys created before this was introduced.", "readOnly": true, "type": "string" }, "name": { "description": "The Token's Name\n\nSet this to help you remember, for example, where you use the token.", "type": "string" }, "owner_id": { "description": "The token's owner", "format": "uuid", "readOnly": true, "type": "string" }, "project_id": { "description": "The Token's Project ID", "format": "uuid", "readOnly": true, "type": "string" }, "updated_at": { "description": "The token's last update date", "format": "date-time", "readOnly": true, "type": "string" }, "value": { "description": "The token's value", "readOnly": true, "type": "string" } }, "required": [ "id", "name", "owner_id" ], "type": "object" }, "projectApiKeys": { "items": { "$ref": "#/components/schemas/projectApiKey" }, "type": "array" }, "projectBranding": { "properties": { "created_at": { "description": "The Customization Creation Date", "format": "date-time", "readOnly": true, "type": "string" }, "default_theme": { "$ref": "#/components/schemas/projectBrandingTheme" }, "id": { "description": "The customization ID.", "format": "uuid", "readOnly": true, "type": "string" }, "project_id": { "description": "The Project's ID this customization is associated with", "format": "uuid", "type": "string" }, "themes": { "$ref": "#/components/schemas/projectBrandingThemes" }, "updated_at": { "description": "Last Time Branding was Updated", "format": "date-time", "readOnly": true, "type": "string" } }, "required": [ "id", "project_id", "default_theme", "themes", "created_at", "updated_at" ], "title": "ProjectBranding holds all settings for customizing the Ory Account Experience.", "type": "object" }, "projectBrandingColors": { "properties": { "accent_default_color": { "description": "AccentDefaultColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "accent_disabled_color": { "description": "AccentDisabledColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "accent_emphasis_color": { "description": "AccentEmphasisColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "accent_muted_color": { "description": "AccentMutedColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "accent_subtle_color": { "description": "AccentSubtleColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "background_canvas_color": { "description": "BackgroundCanvasColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "background_subtle_color": { "description": "BackgroundSubtleColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "background_surface_color": { "description": "BackgroundSurfaceColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "border_default_color": { "description": "BorderDefaultColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "error_default_color": { "description": "ErrorDefaultColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "error_emphasis_color": { "description": "ErrorEmphasisColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "error_muted_color": { "description": "ErrorMutedColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "error_subtle_color": { "description": "ErrorSubtleColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "foreground_default_color": { "description": "ForegroundDefaultColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "foreground_disabled_color": { "description": "ForegroundDisabledColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "foreground_muted_color": { "description": "ForegroundMutedColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "foreground_on_accent_color": { "description": "ForegroundOnAccentColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "foreground_on_dark_color": { "description": "ForegroundOnDarkColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "foreground_on_disabled_color": { "description": "ForegroundOnDisabledColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "foreground_subtle_color": { "description": "ForegroundSubtleColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "input_background_color": { "description": "InputBackgroundColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "input_disabled_color": { "description": "InputDisabledColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "input_placeholder_color": { "description": "InputPlaceholderColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "input_text_color": { "description": "InputTextColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "primary_color": { "description": "Primary color is an hsla color value used to derive the other colors from for the Ory Account Experience theme.", "type": "string" }, "secondary_color": { "description": "Secondary color is a hsla color code used to derive the other colors from for the Ory Account Experience theme.", "type": "string" }, "success_emphasis_color": { "description": "SuccessEmphasisColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "text_default_color": { "description": "TextDefaultColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "text_disabled_color": { "description": "TextDisabledColor is a hex color code used by the Ory Account Experience theme.", "type": "string" } }, "title": "ProjectBrandingColors are the colors used by the Ory Account Experience theme.", "type": "object" }, "projectBrandingTheme": { "properties": { "accent_default_color": { "description": "AccentDefaultColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "accent_disabled_color": { "description": "AccentDisabledColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "accent_emphasis_color": { "description": "AccentEmphasisColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "accent_muted_color": { "description": "AccentMutedColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "accent_subtle_color": { "description": "AccentSubtleColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "background_canvas_color": { "description": "BackgroundCanvasColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "background_subtle_color": { "description": "BackgroundSubtleColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "background_surface_color": { "description": "BackgroundSurfaceColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "border_default_color": { "description": "BorderDefaultColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "created_at": { "description": "The Customization Creation Date.", "format": "date-time", "readOnly": true, "type": "string" }, "error_default_color": { "description": "ErrorDefaultColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "error_emphasis_color": { "description": "ErrorEmphasisColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "error_muted_color": { "description": "ErrorMutedColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "error_subtle_color": { "description": "ErrorSubtleColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "favicon_type": { "description": "Favicon Type\nThe Favicon mime type.", "type": "string" }, "favicon_url": { "description": "Favicon URL\nFavicon can be an https:// or base64:// URL. If the URL is not allowed, the favicon will be stored inside the Ory Network storage bucket.", "type": "string" }, "foreground_default_color": { "description": "ForegroundDefaultColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "foreground_disabled_color": { "description": "ForegroundDisabledColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "foreground_muted_color": { "description": "ForegroundMutedColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "foreground_on_accent_color": { "description": "ForegroundOnAccentColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "foreground_on_dark_color": { "description": "ForegroundOnDarkColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "foreground_on_disabled_color": { "description": "ForegroundOnDisabledColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "foreground_subtle_color": { "description": "ForegroundSubtleColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "id": { "description": "The customization theme ID.", "format": "uuid", "readOnly": true, "type": "string" }, "input_background_color": { "description": "InputBackgroundColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "input_disabled_color": { "description": "InputDisabledColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "input_placeholder_color": { "description": "InputPlaceholderColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "input_text_color": { "description": "InputTextColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "logo_type": { "description": "Logo Type\nThe Logo mime type.", "type": "string" }, "logo_url": { "description": "Logo URL\nLogo can be an https:// or base64:// URL. If the URL is not allowed, the logo will be stored inside the Ory Network storage bucket.", "type": "string" }, "name": { "description": "The customization theme name.", "type": "string" }, "primary_color": { "description": "Primary color is an hsla color value used to derive the other colors from for the Ory Account Experience theme.", "type": "string" }, "project_branding_id": { "description": "The ProjectBranding ID this customization is associated with.", "format": "uuid", "type": "string" }, "secondary_color": { "description": "Secondary color is a hsla color code used to derive the other colors from for the Ory Account Experience theme.", "type": "string" }, "success_emphasis_color": { "description": "SuccessEmphasisColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "text_default_color": { "description": "TextDefaultColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "text_disabled_color": { "description": "TextDisabledColor is a hex color code used by the Ory Account Experience theme.", "type": "string" }, "updated_at": { "description": "Last Time Branding was Updated.", "format": "date-time", "readOnly": true, "type": "string" } }, "required": [ "id", "project_branding_id", "name", "created_at", "updated_at" ], "title": "ProjectBrandingTheme represents a Theme for the Ory Account Experience.", "type": "object" }, "projectBrandingThemes": { "items": { "$ref": "#/components/schemas/projectBrandingTheme" }, "title": "ProjectBrandingThemes is a list of ProjectBrandingTheme.", "type": "array" }, "projectCors": { "properties": { "enabled": { "description": "Whether CORS is enabled for this endpoint.", "type": "boolean" }, "origins": { "description": "The allowed origins. Use `*` to allow all origins. A wildcard can also be used in the subdomain, i.e. `https://*.example.com` will allow all origins on all subdomains of `example.com`.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "projectHost": { "properties": { "host": { "description": "The project's host.", "type": "string" }, "id": { "description": "The mapping's ID.", "format": "uuid", "readOnly": true, "type": "string" }, "project_id": { "description": "The Revision's Project ID", "format": "uuid", "type": "string" } }, "required": [ "id", "host", "project_id" ], "type": "object" }, "projectMember": { "properties": { "break_glass": { "description": "BreakGlass is true when the identity's recovery address has break-glass\nrecovery enabled for the identity's current organization.", "type": "boolean" }, "email": { "type": "string" }, "email_verified": { "type": "boolean" }, "id": { "format": "uuid", "type": "string" }, "name": { "type": "string" }, "organization_id": { "$ref": "#/components/schemas/NullUUID" }, "role": { "description": "The member's role on the project.\nowner has full control, developer can read and write, viewer is read-only.", "enum": [ "owner", "developer", "viewer" ], "type": "string" }, "source": { "description": "Whether the member has access through the project directly or through\nworkspace membership.", "enum": [ "project", "workspace" ], "type": "string" } }, "required": [ "id", "email", "name", "email_verified", "role" ], "type": "object" }, "projectMembers": { "items": { "$ref": "#/components/schemas/projectMember" }, "type": "array" }, "projectMetadata": { "properties": { "created_at": { "description": "The Project's Creation Date", "format": "date-time", "type": "string" }, "environment": { "description": "The environment of the project.\nprod Production\nstage Staging\ndev Development", "enum": [ "prod", "stage", "dev" ], "type": "string", "x-go-enum-desc": "prod Production\nstage Staging\ndev Development" }, "home_region": { "description": "The project's data home region\neu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global", "enum": [ "eu-central", "asia-northeast", "us-east", "us-west", "eu", "asia", "us", "global" ], "type": "string", "x-go-enum-desc": "eu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global" }, "hosts": { "description": "The FQDN hostnames this project listens on", "items": { "type": "string" }, "type": "array" }, "id": { "description": "The project's ID.", "format": "uuid", "readOnly": true, "type": "string" }, "name": { "description": "The project's name if set", "type": "string" }, "slug": { "description": "The project's slug", "readOnly": true, "type": "string" }, "state": { "description": "The state of the project.\nrunning Running\nhalted Halted\ndeleted Deleted", "enum": [ "running", "halted", "deleted" ], "type": "string", "x-go-enum-desc": "running Running\nhalted Halted\ndeleted Deleted" }, "subscription_id": { "$ref": "#/components/schemas/NullUUID" }, "subscription_plan": { "$ref": "#/components/schemas/String" }, "updated_at": { "description": "Last Time Project was Updated", "format": "date-time", "type": "string" }, "workspace": { "$ref": "#/components/schemas/workspace" }, "workspace_id": { "$ref": "#/components/schemas/NullUUID" } }, "required": [ "id", "hosts", "slug", "state", "created_at", "updated_at", "name", "environment", "home_region" ], "type": "object" }, "projectMetadataList": { "items": { "$ref": "#/components/schemas/projectMetadata" }, "type": "array" }, "projectRevisionHooks": { "items": { "$ref": "#/components/schemas/normalizedProjectRevisionHook" }, "type": "array" }, "projectRevisionIdentitySchemas": { "items": { "$ref": "#/components/schemas/normalizedProjectRevisionIdentitySchema" }, "type": "array" }, "projectRevisionSamlProviders": { "items": { "$ref": "#/components/schemas/normalizedProjectRevisionSAMLProvider" }, "type": "array" }, "projectRevisionScimClients": { "items": { "$ref": "#/components/schemas/normalizedProjectRevisionScimClient" }, "type": "array" }, "projectRevisionThirdPartyLoginProviders": { "items": { "$ref": "#/components/schemas/normalizedProjectRevisionThirdPartyProvider" }, "type": "array" }, "projectRevisions": { "items": { "$ref": "#/components/schemas/normalizedProjectRevision" }, "type": "array" }, "projectServiceAccountExperience": { "properties": { "config": { "type": "object" } }, "required": [ "config" ], "type": "object" }, "projectServiceIdentity": { "properties": { "config": { "type": "object" } }, "required": [ "config" ], "type": "object" }, "projectServiceOAuth2": { "properties": { "config": { "type": "object" } }, "required": [ "config" ], "type": "object" }, "projectServicePermission": { "properties": { "config": { "type": "object" } }, "required": [ "config" ], "type": "object" }, "projectServiceTalos": { "properties": { "config": { "type": "object" } }, "required": [ "config" ], "type": "object" }, "projectServices": { "properties": { "account_experience": { "$ref": "#/components/schemas/projectServiceAccountExperience" }, "identity": { "$ref": "#/components/schemas/projectServiceIdentity" }, "oauth2": { "$ref": "#/components/schemas/projectServiceOAuth2" }, "permission": { "$ref": "#/components/schemas/projectServicePermission" }, "talos": { "$ref": "#/components/schemas/projectServiceTalos" } }, "type": "object" }, "quotaUsage": { "properties": { "additional_price": { "description": "The additional price per unit in cents.", "type": "string" }, "can_use_more": { "type": "boolean" }, "feature": { "description": "\nproduction_projects ProductionProjects\nstaging_projects StagingProjects\ndevelopment_projects DevelopmentProjects\ndaily_active_users DailyActiveUsers\ncustom_domains CustomDomains\nevent_streams EventStreams\nevent_stream_events EventStreamEvents\nsla SLA\ncollaborator_seats CollaboratorSeats\nedge_cache EdgeCache\nbranding_themes BrandingThemes\nzendesk_support ZendeskSupport\nzendesk_support_on_call ZendeskSupportOnCall\nproject_metrics ProjectMetrics\nproject_metrics_time_window ProjectMetricsTimeWindow\nproject_metrics_events_history ProjectMetricsEventsHistory\norganizations Organizations\nrop_grant ResourceOwnerPasswordGrant\nconcierge_onboarding ConciergeOnboarding\ncredit Credit\ndata_location_global DataLocationGlobal\ndata_location_us DataLocationUS\ndata_location_asiane DataLocationAsiaNorthEast\nm2m_token_issuance M2MTokenIssuance\npermission_checks PermissionChecks\ncaptcha Captcha\ncaptcha_byo CaptchaBYO\nhide_ory_branding HideOryBranding\nidentity_search_api IdentitySearchAPI\nsaml_sp SAMLSP\nsaml_idp SAMLIDP\nauto_link_policy AutoLinkPolicy\nscim_clients SCIMClients\ndefault_smtp_email_customization DefaultSMTPEmailCustomization\nonboarding_portal OnboardingPortal\nconsole_organization_sso ConsoleOrganizationSSO\ntalos_api_keys TalosAPIKeys\ntalos_rate_limit TalosRateLimit\ntalos_cache TalosCache\ngraceful_refresh_token_count GracefulRefreshTokenCount\nhydra_token_prefix HydraTokenPrefix\nhydra_device_authorization HydraDeviceAuthorization\ndeviceauthn Deviceauthn\nallow_insecure_origins AllowInsecureOrigins AllowInsecureOrigins grandfathers a project past strict wildcard enforcement (CORS origins + return URLs). Override-only; never sold.\nupdate_self_service_registration_rate_limit_tier RateLimitTierUpdateSelfServiceRegistration Self-service rate limits\nupdate_self_service_recovery_rate_limit_tier RateLimitTierUpdateSelfServiceRecovery\nupdate_self_service_settings_rate_limit_tier RateLimitTierUpdateSelfServiceSettings\nupdate_self_service_verification_rate_limit_tier RateLimitTierUpdateSelfServiceVerification\nidentities_create_rate_limit_tier RateLimitTierIdentitiesCreate\nidentities_import_rate_limit_tier RateLimitTierIdentitiesImport\nfed_cm_parameters_rate_limit_tier RateLimitTierFedCMParameters\ndata_location_regional DataLocationRegional Required Features\nrate_limit_tier RateLimitTier\nsession_rate_limit_tier RateLimitTierSessions\nidentities_list_rate_limit_tier RateLimitTierIdentitiesList\npermission_checks_rate_limit_tier RateLimitTierPermissionChecks\noauth2_introspect_rate_limit_tier RateLimitTierOAuth2Introspect\ncreate_recovery_admin_rate_limit_tier RateLimitTierCreateAdminRecovery\nscim_rate_limit_tier RateLimitTierSCIM\nhydra_admin_high_rate_limit_tier RateLimitTierHydraAdminHigh Bucket-specific rate limit tiers\nhydra_admin_medium_rate_limit_tier RateLimitTierHydraAdminMedium\nhydra_admin_low_rate_limit_tier RateLimitTierHydraAdminLow\nhydra_public_high_rate_limit_tier RateLimitTierHydraPublicHigh\nhydra_public_medium_rate_limit_tier RateLimitTierHydraPublicMedium\nhydra_public_low_rate_limit_tier RateLimitTierHydraPublicLow\nketo_admin_low_rate_limit_tier RateLimitTierKetoAdminLow\nketo_admin_medium_rate_limit_tier RateLimitTierKetoAdminMedium\nketo_public_high_rate_limit_tier RateLimitTierKetoPublicHigh\nkratos_admin_high_rate_limit_tier RateLimitTierKratosAdminHigh\nkratos_admin_medium_rate_limit_tier RateLimitTierKratosAdminMedium\nkratos_admin_low_rate_limit_tier RateLimitTierKratosAdminLow\nkratos_public_high_rate_limit_tier RateLimitTierKratosPublicHigh\nkratos_public_medium_rate_limit_tier RateLimitTierKratosPublicMedium\nkratos_public_low_rate_limit_tier RateLimitTierKratosPublicLow\npolis_public_high_rate_limit_tier RateLimitTierPolisPublicHigh\npolis_public_medium_rate_limit_tier RateLimitTierPolisPublicMedium\ntalos_admin_high_rate_limit_tier RateLimitTierTalosAdminHigh\ntalos_admin_medium_rate_limit_tier RateLimitTierTalosAdminMedium\ntalos_admin_low_rate_limit_tier RateLimitTierTalosAdminLow\ntalos_public_high_rate_limit_tier RateLimitTierTalosPublicHigh\ntalos_public_low_rate_limit_tier RateLimitTierTalosPublicLow\nunassigned_rate_limit_tier RateLimitTierUnassigned", "enum": [ "production_projects", "staging_projects", "development_projects", "daily_active_users", "custom_domains", "event_streams", "event_stream_events", "sla", "collaborator_seats", "edge_cache", "branding_themes", "zendesk_support", "zendesk_support_on_call", "project_metrics", "project_metrics_time_window", "project_metrics_events_history", "organizations", "rop_grant", "concierge_onboarding", "credit", "data_location_global", "data_location_us", "data_location_asiane", "m2m_token_issuance", "permission_checks", "captcha", "captcha_byo", "hide_ory_branding", "identity_search_api", "saml_sp", "saml_idp", "auto_link_policy", "scim_clients", "default_smtp_email_customization", "onboarding_portal", "console_organization_sso", "talos_api_keys", "talos_rate_limit", "talos_cache", "graceful_refresh_token_count", "hydra_token_prefix", "hydra_device_authorization", "deviceauthn", "allow_insecure_origins", "update_self_service_registration_rate_limit_tier", "update_self_service_recovery_rate_limit_tier", "update_self_service_settings_rate_limit_tier", "update_self_service_verification_rate_limit_tier", "identities_create_rate_limit_tier", "identities_import_rate_limit_tier", "fed_cm_parameters_rate_limit_tier", "data_location_regional", "rate_limit_tier", "session_rate_limit_tier", "identities_list_rate_limit_tier", "permission_checks_rate_limit_tier", "oauth2_introspect_rate_limit_tier", "create_recovery_admin_rate_limit_tier", "scim_rate_limit_tier", "hydra_admin_high_rate_limit_tier", "hydra_admin_medium_rate_limit_tier", "hydra_admin_low_rate_limit_tier", "hydra_public_high_rate_limit_tier", "hydra_public_medium_rate_limit_tier", "hydra_public_low_rate_limit_tier", "keto_admin_low_rate_limit_tier", "keto_admin_medium_rate_limit_tier", "keto_public_high_rate_limit_tier", "kratos_admin_high_rate_limit_tier", "kratos_admin_medium_rate_limit_tier", "kratos_admin_low_rate_limit_tier", "kratos_public_high_rate_limit_tier", "kratos_public_medium_rate_limit_tier", "kratos_public_low_rate_limit_tier", "polis_public_high_rate_limit_tier", "polis_public_medium_rate_limit_tier", "talos_admin_high_rate_limit_tier", "talos_admin_medium_rate_limit_tier", "talos_admin_low_rate_limit_tier", "talos_public_high_rate_limit_tier", "talos_public_low_rate_limit_tier", "unassigned_rate_limit_tier" ], "type": "string", "x-go-enum-desc": "production_projects ProductionProjects\nstaging_projects StagingProjects\ndevelopment_projects DevelopmentProjects\ndaily_active_users DailyActiveUsers\ncustom_domains CustomDomains\nevent_streams EventStreams\nevent_stream_events EventStreamEvents\nsla SLA\ncollaborator_seats CollaboratorSeats\nedge_cache EdgeCache\nbranding_themes BrandingThemes\nzendesk_support ZendeskSupport\nzendesk_support_on_call ZendeskSupportOnCall\nproject_metrics ProjectMetrics\nproject_metrics_time_window ProjectMetricsTimeWindow\nproject_metrics_events_history ProjectMetricsEventsHistory\norganizations Organizations\nrop_grant ResourceOwnerPasswordGrant\nconcierge_onboarding ConciergeOnboarding\ncredit Credit\ndata_location_global DataLocationGlobal\ndata_location_us DataLocationUS\ndata_location_asiane DataLocationAsiaNorthEast\nm2m_token_issuance M2MTokenIssuance\npermission_checks PermissionChecks\ncaptcha Captcha\ncaptcha_byo CaptchaBYO\nhide_ory_branding HideOryBranding\nidentity_search_api IdentitySearchAPI\nsaml_sp SAMLSP\nsaml_idp SAMLIDP\nauto_link_policy AutoLinkPolicy\nscim_clients SCIMClients\ndefault_smtp_email_customization DefaultSMTPEmailCustomization\nonboarding_portal OnboardingPortal\nconsole_organization_sso ConsoleOrganizationSSO\ntalos_api_keys TalosAPIKeys\ntalos_rate_limit TalosRateLimit\ntalos_cache TalosCache\ngraceful_refresh_token_count GracefulRefreshTokenCount\nhydra_token_prefix HydraTokenPrefix\nhydra_device_authorization HydraDeviceAuthorization\ndeviceauthn Deviceauthn\nallow_insecure_origins AllowInsecureOrigins AllowInsecureOrigins grandfathers a project past strict wildcard enforcement (CORS origins + return URLs). Override-only; never sold.\nupdate_self_service_registration_rate_limit_tier RateLimitTierUpdateSelfServiceRegistration Self-service rate limits\nupdate_self_service_recovery_rate_limit_tier RateLimitTierUpdateSelfServiceRecovery\nupdate_self_service_settings_rate_limit_tier RateLimitTierUpdateSelfServiceSettings\nupdate_self_service_verification_rate_limit_tier RateLimitTierUpdateSelfServiceVerification\nidentities_create_rate_limit_tier RateLimitTierIdentitiesCreate\nidentities_import_rate_limit_tier RateLimitTierIdentitiesImport\nfed_cm_parameters_rate_limit_tier RateLimitTierFedCMParameters\ndata_location_regional DataLocationRegional Required Features\nrate_limit_tier RateLimitTier\nsession_rate_limit_tier RateLimitTierSessions\nidentities_list_rate_limit_tier RateLimitTierIdentitiesList\npermission_checks_rate_limit_tier RateLimitTierPermissionChecks\noauth2_introspect_rate_limit_tier RateLimitTierOAuth2Introspect\ncreate_recovery_admin_rate_limit_tier RateLimitTierCreateAdminRecovery\nscim_rate_limit_tier RateLimitTierSCIM\nhydra_admin_high_rate_limit_tier RateLimitTierHydraAdminHigh Bucket-specific rate limit tiers\nhydra_admin_medium_rate_limit_tier RateLimitTierHydraAdminMedium\nhydra_admin_low_rate_limit_tier RateLimitTierHydraAdminLow\nhydra_public_high_rate_limit_tier RateLimitTierHydraPublicHigh\nhydra_public_medium_rate_limit_tier RateLimitTierHydraPublicMedium\nhydra_public_low_rate_limit_tier RateLimitTierHydraPublicLow\nketo_admin_low_rate_limit_tier RateLimitTierKetoAdminLow\nketo_admin_medium_rate_limit_tier RateLimitTierKetoAdminMedium\nketo_public_high_rate_limit_tier RateLimitTierKetoPublicHigh\nkratos_admin_high_rate_limit_tier RateLimitTierKratosAdminHigh\nkratos_admin_medium_rate_limit_tier RateLimitTierKratosAdminMedium\nkratos_admin_low_rate_limit_tier RateLimitTierKratosAdminLow\nkratos_public_high_rate_limit_tier RateLimitTierKratosPublicHigh\nkratos_public_medium_rate_limit_tier RateLimitTierKratosPublicMedium\nkratos_public_low_rate_limit_tier RateLimitTierKratosPublicLow\npolis_public_high_rate_limit_tier RateLimitTierPolisPublicHigh\npolis_public_medium_rate_limit_tier RateLimitTierPolisPublicMedium\ntalos_admin_high_rate_limit_tier RateLimitTierTalosAdminHigh\ntalos_admin_medium_rate_limit_tier RateLimitTierTalosAdminMedium\ntalos_admin_low_rate_limit_tier RateLimitTierTalosAdminLow\ntalos_public_high_rate_limit_tier RateLimitTierTalosPublicHigh\ntalos_public_low_rate_limit_tier RateLimitTierTalosPublicLow\nunassigned_rate_limit_tier RateLimitTierUnassigned" }, "feature_available": { "type": "boolean" }, "included": { "format": "int64", "type": "integer" }, "is_unlimited": { "type": "boolean" }, "used": { "format": "int64", "type": "integer" } }, "required": [ "feature", "included", "used", "is_unlimited", "additional_price", "can_use_more", "feature_available" ], "type": "object" }, "recoveryCodeForIdentity": { "description": "Used when an administrator creates a recovery code for an identity.", "properties": { "expires_at": { "description": "Expires At is the timestamp of when the recovery flow expires\n\nThe timestamp when the recovery code expires.", "format": "date-time", "type": "string" }, "recovery_code": { "description": "RecoveryCode is the code that can be used to recover the account", "type": "string" }, "recovery_link": { "description": "RecoveryLink with flow\n\nThis link opens the recovery UI with an empty `code` field.", "type": "string" } }, "required": [ "recovery_link", "recovery_code" ], "title": "Recovery Code for Identity", "type": "object" }, "recoveryFlow": { "description": "This request is used when an identity wants to recover their account.\n\nWe recommend reading the [Account Recovery Documentation](../self-service/flows/password-reset-account-recovery)", "properties": { "active": { "description": "Active, if set, contains the recovery method that is being used. It is initially\nnot set.", "type": "string" }, "continue_with": { "description": "Contains possible actions that could follow this flow", "items": { "$ref": "#/components/schemas/continueWith" }, "type": "array" }, "expires_at": { "description": "ExpiresAt is the time (UTC) when the request expires. If the user still wishes to update the setting,\na new request has to be initiated.", "format": "date-time", "type": "string" }, "id": { "description": "ID represents the request's unique ID. When performing the recovery flow, this\nrepresents the id in the recovery ui's query parameter: http://\u003cselfservice.flows.recovery.ui_url\u003e?request=\u003cid\u003e", "format": "uuid", "type": "string" }, "issued_at": { "description": "IssuedAt is the time (UTC) when the request occurred.", "format": "date-time", "type": "string" }, "request_url": { "description": "RequestURL is the initial URL that was requested from Ory Kratos. It can be used\nto forward information contained in the URL's path or query for example.", "type": "string" }, "return_to": { "description": "ReturnTo contains the requested return_to URL.", "type": "string" }, "state": { "description": "State represents the state of this request:\n\nchoose_method: ask the user to choose a method (e.g. recover account via email)\nsent_email: the email has been sent to the user\npassed_challenge: the request was successful and the recovery challenge was passed." }, "transient_payload": { "description": "TransientPayload is used to pass data from the recovery flow to hooks and email templates", "type": "object" }, "type": { "$ref": "#/components/schemas/selfServiceFlowType" }, "ui": { "$ref": "#/components/schemas/uiContainer" } }, "required": [ "id", "type", "expires_at", "issued_at", "request_url", "ui", "state" ], "title": "A Recovery Flow", "type": "object" }, "recoveryFlowState": { "description": "The experimental state represents the state of a recovery flow. This field is EXPERIMENTAL and subject to change!", "enum": [ "choose_method", "sent_email", "passed_challenge" ], "title": "Recovery flow state (experimental)" }, "recoveryIdentityAddress": { "properties": { "break_glass_for_organization": { "$ref": "#/components/schemas/NullUUID" }, "created_at": { "description": "CreatedAt is a helper struct field for gobuffalo.pop.", "format": "date-time", "type": "string" }, "id": { "format": "uuid", "type": "string" }, "updated_at": { "description": "UpdatedAt is a helper struct field for gobuffalo.pop.", "format": "date-time", "type": "string" }, "value": { "type": "string" }, "via": { "type": "string" } }, "required": [ "value", "via" ], "type": "object" }, "recoveryLinkForIdentity": { "description": "Used when an administrator creates a recovery link for an identity.", "properties": { "expires_at": { "description": "Recovery Link Expires At\n\nThe timestamp when the recovery link expires.", "format": "date-time", "type": "string" }, "recovery_link": { "description": "Recovery Link\n\nThis link can be used to recover the account.", "type": "string" } }, "required": [ "recovery_link" ], "title": "Identity Recovery Link", "type": "object" }, "registrationFlow": { "properties": { "active": { "description": "Active, if set, contains the registration method that is being used. It is initially\nnot set.\npassword CredentialsTypePassword\noidc CredentialsTypeOIDC\ntotp CredentialsTypeTOTP\nlookup_secret CredentialsTypeLookup\nwebauthn CredentialsTypeWebAuthn\ncode CredentialsTypeCodeAuth\npasskey CredentialsTypePasskey\nprofile CredentialsTypeProfile\nsaml CredentialsTypeSAML\ndeviceauthn CredentialsTypeDeviceAuthn\nidentifier_first CredentialsTypeIdentifierFirst\nlink_recovery CredentialsTypeRecoveryLink CredentialsTypeRecoveryLink is a special credential type linked to the link strategy (recovery flow). It is not used within the credentials object itself.\ncode_recovery CredentialsTypeRecoveryCode", "enum": [ "password", "oidc", "totp", "lookup_secret", "webauthn", "code", "passkey", "profile", "saml", "deviceauthn", "identifier_first", "link_recovery", "code_recovery" ], "type": "string", "x-go-enum-desc": "password CredentialsTypePassword\noidc CredentialsTypeOIDC\ntotp CredentialsTypeTOTP\nlookup_secret CredentialsTypeLookup\nwebauthn CredentialsTypeWebAuthn\ncode CredentialsTypeCodeAuth\npasskey CredentialsTypePasskey\nprofile CredentialsTypeProfile\nsaml CredentialsTypeSAML\ndeviceauthn CredentialsTypeDeviceAuthn\nidentifier_first CredentialsTypeIdentifierFirst\nlink_recovery CredentialsTypeRecoveryLink CredentialsTypeRecoveryLink is a special credential type linked to the link strategy (recovery flow). It is not used within the credentials object itself.\ncode_recovery CredentialsTypeRecoveryCode" }, "expires_at": { "description": "ExpiresAt is the time (UTC) when the flow expires. If the user still wishes to log in,\na new flow has to be initiated.", "format": "date-time", "type": "string" }, "id": { "description": "ID represents the flow's unique ID. When performing the registration flow, this\nrepresents the id in the registration ui's query parameter: http://\u003cselfservice.flows.registration.ui_url\u003e/?flow=\u003cid\u003e", "format": "uuid", "type": "string" }, "identity_schema": { "description": "IdentitySchema optionally holds the ID of the identity schema that is used\nfor this flow. This value can be set by the user when creating the flow and\nshould be retained when the flow is saved or converted to another flow.", "type": "string" }, "issued_at": { "description": "IssuedAt is the time (UTC) when the flow occurred.", "format": "date-time", "type": "string" }, "oauth2_login_challenge": { "description": "Ory OAuth 2.0 Login Challenge.\n\nThis value is set using the `login_challenge` query parameter of the registration and login endpoints.\nIf set will cooperate with Ory OAuth2 and OpenID to act as an OAuth2 server / OpenID Provider.", "type": "string" }, "oauth2_login_request": { "$ref": "#/components/schemas/oAuth2LoginRequest" }, "organization_id": { "$ref": "#/components/schemas/NullUUID" }, "request_url": { "description": "RequestURL is the initial URL that was requested from Ory Kratos. It can be used\nto forward information contained in the URL's path or query for example.", "type": "string" }, "return_to": { "description": "ReturnTo contains the requested return_to URL.", "type": "string" }, "session_token_exchange_code": { "description": "SessionTokenExchangeCode holds the secret code that the client can use to retrieve a session token after the flow has been completed.\nThis is only set if the client has requested a session token exchange code, and if the flow is of type \"api\",\nand only on creating the flow.", "type": "string" }, "state": { "description": "State represents the state of this request:\n\nchoose_method: ask the user to choose a method (e.g. registration with email)\nsent_email: the email has been sent to the user\npassed_challenge: the request was successful and the registration challenge was passed." }, "transient_payload": { "description": "TransientPayload is used to pass data from the registration to a webhook", "type": "object" }, "type": { "$ref": "#/components/schemas/selfServiceFlowType" }, "ui": { "$ref": "#/components/schemas/uiContainer" } }, "required": [ "id", "type", "expires_at", "issued_at", "request_url", "ui", "state" ], "type": "object" }, "registrationFlowState": { "description": "The experimental state represents the state of a registration flow. This field is EXPERIMENTAL and subject to change!", "enum": [ "choose_method", "sent_email", "passed_challenge" ], "title": "Registration flow state (experimental)", "type": "string" }, "rejectOAuth2Request": { "properties": { "error": { "description": "The error should follow the OAuth2 error format (e.g. `invalid_request`, `login_required`).\n\nDefaults to `request_denied`.", "type": "string" }, "error_debug": { "description": "Debug contains information to help resolve the problem as a developer. Usually not exposed\nto the public but only in the server logs.", "type": "string" }, "error_description": { "description": "Description of the error in a human readable format.", "type": "string" }, "error_hint": { "description": "Hint to help resolve the error.", "type": "string" }, "status_code": { "description": "Represents the HTTP status code of the error (e.g. 401 or 403)\n\nDefaults to 400", "format": "int64", "type": "integer" } }, "title": "The request payload used to accept a login or consent request.", "type": "object" }, "relationQuery": { "description": "Relation Query", "properties": { "namespace": { "description": "Namespace to query", "type": "string" }, "object": { "description": "Object to query", "type": "string" }, "relation": { "description": "Relation to query", "type": "string" }, "subject_id": { "description": "SubjectID to query\n\nEither SubjectSet or SubjectID can be provided.", "type": "string" }, "subject_set": { "$ref": "#/components/schemas/subjectSet" } }, "type": "object" }, "relationship": { "description": "Relationship", "properties": { "namespace": { "description": "Namespace of the Relation Tuple", "type": "string" }, "object": { "description": "Object of the Relation Tuple", "type": "string" }, "relation": { "description": "Relation of the Relation Tuple", "type": "string" }, "subject_id": { "description": "SubjectID of the Relation Tuple\n\nEither SubjectSet or SubjectID can be provided.", "type": "string" }, "subject_set": { "$ref": "#/components/schemas/subjectSet" } }, "required": [ "namespace", "object", "relation" ], "type": "object" }, "relationshipNamespaces": { "description": "Relationship Namespace List", "properties": { "namespaces": { "items": { "$ref": "#/components/schemas/namespace" }, "type": "array" } }, "type": "object" }, "relationshipPatch": { "description": "Payload for patching a relationship", "properties": { "action": { "enum": [ "insert", "delete" ], "type": "string", "x-go-enum-desc": "insert ActionInsert\ndelete ActionDelete" }, "relation_tuple": { "$ref": "#/components/schemas/relationship" } }, "type": "object" }, "relationships": { "description": "Paginated Relationship List", "properties": { "next_page_token": { "description": "The opaque token to provide in a subsequent request\nto get the next page. It is the empty string iff this is\nthe last page.", "type": "string" }, "relation_tuples": { "items": { "$ref": "#/components/schemas/relationship" }, "type": "array" } }, "type": "object" }, "revisionCourierChannels": { "items": { "$ref": "#/components/schemas/NormalizedProjectRevisionCourierChannel" }, "type": "array" }, "rotateTalosKeyBody": { "description": "Rotate Talos key request body", "properties": { "mode": { "default": "graceful", "description": "Rotation mode. Use \"graceful\" to keep the old key for verification of\nexisting tokens, or \"revoke\" to discard it immediately.", "enum": [ "graceful", "revoke" ], "type": "string" } }, "type": "object" }, "schemaPatch": { "properties": { "data": { "description": "The json schema", "type": "object" }, "name": { "description": "The user defined schema name", "type": "string" } }, "required": [ "name", "data" ], "type": "object" }, "selfServiceFlowExpiredError": { "description": "Is sent when a flow is expired", "properties": { "error": { "$ref": "#/components/schemas/genericError" }, "expired_at": { "description": "When the flow has expired", "format": "date-time", "type": "string" }, "since": { "$ref": "#/components/schemas/Duration" }, "use_flow_id": { "description": "The flow ID that should be used for the new flow as it contains the correct messages.", "format": "uuid", "type": "string" } }, "type": "object" }, "selfServiceFlowType": { "description": "The flow type can either be `api` or `browser`.", "title": "Type is the flow type.", "type": "string" }, "session": { "description": "A Session", "properties": { "active": { "description": "Active state. If false the session is no longer active.", "type": "boolean" }, "authenticated_at": { "description": "The Session Authentication Timestamp\n\nWhen this session was authenticated at. If multi-factor authentication was used this\nis the time when the last factor was authenticated (e.g. the TOTP code challenge was completed).", "format": "date-time", "type": "string" }, "authentication_methods": { "$ref": "#/components/schemas/sessionAuthenticationMethods" }, "authenticator_assurance_level": { "$ref": "#/components/schemas/authenticatorAssuranceLevel" }, "devices": { "description": "Devices has history of all endpoints where the session was used", "items": { "$ref": "#/components/schemas/sessionDevice" }, "type": "array" }, "expires_at": { "description": "The Session Expiry\n\nWhen this session expires at.", "format": "date-time", "type": "string" }, "id": { "description": "Session ID", "format": "uuid", "type": "string" }, "identity": { "$ref": "#/components/schemas/identity" }, "issued_at": { "description": "The Session Issuance Timestamp\n\nWhen this session was issued at. Usually equal or close to `authenticated_at`.", "format": "date-time", "type": "string" }, "tokenized": { "description": "Tokenized is the tokenized (e.g. JWT) version of the session.\n\nIt is only set when the `tokenize_as` query parameter was set to a valid tokenize template during calls to `/session/whoami`.", "type": "string" } }, "required": [ "id" ], "type": "object" }, "sessionAuthenticationMethod": { "description": "A singular authenticator used during authentication / login.", "properties": { "aal": { "$ref": "#/components/schemas/authenticatorAssuranceLevel" }, "completed_at": { "description": "When the authentication challenge was completed.", "format": "date-time", "type": "string" }, "method": { "description": "The method used in this authenticator.\npassword CredentialsTypePassword\noidc CredentialsTypeOIDC\ntotp CredentialsTypeTOTP\nlookup_secret CredentialsTypeLookup\nwebauthn CredentialsTypeWebAuthn\ncode CredentialsTypeCodeAuth\npasskey CredentialsTypePasskey\nprofile CredentialsTypeProfile\nsaml CredentialsTypeSAML\ndeviceauthn CredentialsTypeDeviceAuthn\nidentifier_first CredentialsTypeIdentifierFirst\nlink_recovery CredentialsTypeRecoveryLink CredentialsTypeRecoveryLink is a special credential type linked to the link strategy (recovery flow). It is not used within the credentials object itself.\ncode_recovery CredentialsTypeRecoveryCode", "enum": [ "password", "oidc", "totp", "lookup_secret", "webauthn", "code", "passkey", "profile", "saml", "deviceauthn", "identifier_first", "link_recovery", "code_recovery" ], "type": "string", "x-go-enum-desc": "password CredentialsTypePassword\noidc CredentialsTypeOIDC\ntotp CredentialsTypeTOTP\nlookup_secret CredentialsTypeLookup\nwebauthn CredentialsTypeWebAuthn\ncode CredentialsTypeCodeAuth\npasskey CredentialsTypePasskey\nprofile CredentialsTypeProfile\nsaml CredentialsTypeSAML\ndeviceauthn CredentialsTypeDeviceAuthn\nidentifier_first CredentialsTypeIdentifierFirst\nlink_recovery CredentialsTypeRecoveryLink CredentialsTypeRecoveryLink is a special credential type linked to the link strategy (recovery flow). It is not used within the credentials object itself.\ncode_recovery CredentialsTypeRecoveryCode" }, "organization": { "description": "The Organization id used for authentication", "type": "string" }, "provider": { "description": "OIDC or SAML provider id used for authentication", "type": "string" }, "upstream_acr": { "description": "UpstreamACR is the `acr` claim reported by the upstream OIDC\nprovider, if any. Populated only for OIDC login methods when the\nupstream ID token contained an `acr` claim.", "type": "string" }, "upstream_amr": { "description": "UpstreamAMR is the `amr` claim reported by the upstream OIDC\nprovider, if any. Populated only for OIDC login methods when the\nupstream ID token contained an `amr` claim.", "items": { "type": "string" }, "type": "array" } }, "title": "AuthenticationMethod identifies an authentication method", "type": "object" }, "sessionAuthenticationMethods": { "description": "A list of authenticators which were used to authenticate the session.", "items": { "$ref": "#/components/schemas/sessionAuthenticationMethod" }, "title": "List of (Used) AuthenticationMethods", "type": "array" }, "sessionDevice": { "description": "Device corresponding to a Session", "properties": { "id": { "description": "Device record ID", "format": "uuid", "type": "string" }, "ip_address": { "description": "IPAddress of the client", "type": "string" }, "location": { "description": "Geo Location corresponding to the IP Address", "type": "string" }, "user_agent": { "description": "UserAgent of the client", "type": "string" } }, "required": [ "id" ], "type": "object" }, "setCustomDomainBody": { "description": "Update Custom Hostname Body", "properties": { "cookie_domain": { "description": "The domain where cookies will be set. Has to be a parent domain of the custom hostname to work.", "type": "string" }, "cors_allowed_origins": { "description": "CORS Allowed origins for the custom hostname.", "items": { "type": "string" }, "type": "array" }, "cors_enabled": { "description": "CORS Enabled for the custom hostname.", "type": "boolean" }, "custom_ui_base_url": { "description": "The custom UI base URL where the UI will be exposed.", "type": "string" }, "hostname": { "description": "The custom hostname where the API will be exposed.", "type": "string" } }, "type": "object" }, "setEventStreamBody": { "description": "All fields are optional. Omitted fields keep their current value, so a caller\ncan change only the status (pause/resume) without resubmitting the\ndestination. This matters because secrets such as the password in an HTTPS\nendpoint URL are redacted in API responses, and resubmitting the redacted\nvalue would overwrite the real one.", "properties": { "https_endpoint": { "description": "The HTTPS endpoint URL to send events to. When omitted, the current value is kept.", "type": "string" }, "role_arn": { "description": "The AWS IAM role ARN to assume when publishing to the SNS topic. When omitted, the current value is kept.", "type": "string" }, "status": { "description": "The desired status of the event stream. When omitted, the current status is kept.", "enum": [ "active", "paused" ], "type": "string" }, "topic_arn": { "description": "The AWS SNS topic ARN. When omitted, the current value is kept.", "type": "string" }, "type": { "description": "The type of the event stream (AWS SNS or HTTPS webhook). When omitted, the\ncurrent type and its destination settings are kept.", "enum": [ "sns", "https" ], "type": "string" } }, "title": "Update Event Stream Body", "type": "object" }, "setOrganizationFromOnboardingPortalLinkBody": { "properties": { "kratos_selfservice_methods_oidc_config_providers": { "$ref": "#/components/schemas/projectRevisionThirdPartyLoginProviders" }, "kratos_selfservice_methods_saml_config_providers": { "$ref": "#/components/schemas/projectRevisionSamlProviders" }, "revision_id": { "format": "uuid", "type": "string" }, "scim_clients": { "$ref": "#/components/schemas/projectRevisionScimClients" } }, "required": [ "revision_id" ], "type": "object" }, "setProject": { "properties": { "cors_admin": { "$ref": "#/components/schemas/projectCors" }, "cors_public": { "$ref": "#/components/schemas/projectCors" }, "name": { "description": "The name of the project.", "type": "string" }, "organizations": { "description": "The organizations that are part of this project.", "items": { "$ref": "#/components/schemas/basicOrganization" }, "type": "array" }, "services": { "$ref": "#/components/schemas/projectServices" } }, "required": [ "services", "name", "cors_public", "cors_admin", "organizations" ], "type": "object" }, "setProjectBrandingThemeBody": { "properties": { "favicon_type": { "description": "Favicon Type", "type": "string" }, "favicon_url": { "description": "Favicon URL", "type": "string" }, "logo_type": { "description": "Logo type", "type": "string" }, "logo_url": { "description": "Logo URL", "type": "string" }, "name": { "description": "Branding name", "type": "string" }, "theme": { "$ref": "#/components/schemas/projectBrandingColors" } }, "title": "SetProjectBrandingThemeBody is the request body for the set project branding theme endpoint.", "type": "object" }, "settingsFlow": { "description": "This flow is used when an identity wants to update settings\n(e.g. profile data, passwords, ...) in a selfservice manner.\n\nWe recommend reading the [User Settings Documentation](../self-service/flows/user-settings)", "properties": { "active": { "description": "Active, if set, contains the registration method that is being used. It is initially\nnot set.", "type": "string" }, "continue_with": { "description": "Contains a list of actions, that could follow this flow\n\nIt can, for example, contain a reference to the verification flow, created as part of the user's\nregistration.", "items": { "$ref": "#/components/schemas/continueWith" }, "type": "array" }, "expires_at": { "description": "ExpiresAt is the time (UTC) when the flow expires. If the user still wishes to update the setting,\na new flow has to be initiated.", "format": "date-time", "type": "string" }, "id": { "description": "ID represents the flow's unique ID. When performing the settings flow, this\nrepresents the id in the settings ui's query parameter: http://\u003cselfservice.flows.settings.ui_url\u003e?flow=\u003cid\u003e", "format": "uuid", "type": "string" }, "identity": { "$ref": "#/components/schemas/identity" }, "issued_at": { "description": "IssuedAt is the time (UTC) when the flow occurred.", "format": "date-time", "type": "string" }, "organization_id": { "$ref": "#/components/schemas/NullUUID" }, "request_url": { "description": "RequestURL is the initial URL that was requested from Ory Kratos. It can be used\nto forward information contained in the URL's path or query for example.", "type": "string" }, "return_to": { "description": "ReturnTo contains the requested return_to URL.", "type": "string" }, "state": { "description": "State represents the state of this flow. It knows two states:\n\nshow_form: No user data has been collected, or it is invalid, and thus the form should be shown.\nsuccess: Indicates that the settings flow has been updated successfully with the provided data.\nDone will stay true when repeatedly checking. If set to true, done will revert back to false only\nwhen a flow with invalid (e.g. \"please use a valid phone number\") data was sent." }, "transient_payload": { "description": "TransientPayload is used to pass data from the settings flow to hooks and email templates", "type": "object" }, "type": { "$ref": "#/components/schemas/selfServiceFlowType" }, "ui": { "$ref": "#/components/schemas/uiContainer" } }, "required": [ "id", "type", "expires_at", "issued_at", "request_url", "ui", "identity", "state" ], "title": "Flow represents a Settings Flow", "type": "object" }, "settingsFlowState": { "description": "The experimental state represents the state of a settings flow. This field is EXPERIMENTAL and subject to change!", "enum": [ "show_form", "success" ], "title": "Settings flow state (experimental)", "type": "string" }, "subjectSet": { "properties": { "namespace": { "description": "Namespace of the Subject Set", "type": "string" }, "object": { "description": "Object of the Subject Set", "type": "string" }, "relation": { "description": "Relation of the Subject Set", "type": "string" } }, "required": [ "namespace", "object", "relation" ], "type": "object" }, "subscription": { "properties": { "created_at": { "format": "date-time", "readOnly": true, "type": "string" }, "currency": { "description": "The currency of the subscription. To change this, a new subscription must be created.\nusd USD\neur Euro", "enum": [ "usd", "eur" ], "readOnly": true, "type": "string", "x-go-enum-desc": "usd USD\neur Euro" }, "current_interval": { "description": "The currently active interval of the subscription\nmonthly Monthly\nyearly Yearly", "enum": [ "monthly", "yearly" ], "readOnly": true, "type": "string", "x-go-enum-desc": "monthly Monthly\nyearly Yearly" }, "current_plan": { "description": "The currently active plan of the subscription", "readOnly": true, "type": "string" }, "current_plan_details": { "$ref": "#/components/schemas/PlanDetails" }, "customer_id": { "description": "The ID of the stripe customer", "readOnly": true, "type": "string" }, "id": { "description": "The ID of the subscription", "format": "uuid", "readOnly": true, "type": "string" }, "interval_changes_to": { "$ref": "#/components/schemas/String" }, "ongoing_stripe_checkout_id": { "$ref": "#/components/schemas/String" }, "payed_until": { "description": "Until when the subscription is payed", "format": "date-time", "readOnly": true, "type": "string" }, "plan_changes_at": { "$ref": "#/components/schemas/Time" }, "plan_changes_to": { "$ref": "#/components/schemas/String" }, "status": { "$ref": "#/components/schemas/SubscriptionStatus" }, "stripe_checkout_expires_at": { "$ref": "#/components/schemas/Time" }, "updated_at": { "format": "date-time", "readOnly": true, "type": "string" } }, "required": [ "id", "customer_id", "status", "payed_until", "current_plan", "current_interval", "plan_changes_to", "interval_changes_to", "currency", "created_at", "updated_at" ], "type": "object" }, "successfulCodeExchangeResponse": { "description": "The Response for Registration Flows via API", "properties": { "session": { "$ref": "#/components/schemas/session" }, "session_token": { "description": "The Session Token\n\nA session token is equivalent to a session cookie, but it can be sent in the HTTP Authorization\nHeader:\n\nAuthorization: bearer ${session-token}\n\nThe session token is only issued for API flows, not for Browser flows!", "type": "string" } }, "required": [ "session" ], "type": "object" }, "successfulNativeLogin": { "description": "The Response for Login Flows via API", "properties": { "continue_with": { "description": "Contains a list of actions, that could follow this flow\n\nIt can, for example, this will contain a reference to the verification flow, created as part of the user's\nregistration or the token of the session.", "items": { "$ref": "#/components/schemas/continueWith" }, "type": "array" }, "session": { "$ref": "#/components/schemas/session" }, "session_token": { "description": "The Session Token\n\nA session token is equivalent to a session cookie, but it can be sent in the HTTP Authorization\nHeader:\n\nAuthorization: bearer ${session-token}\n\nThe session token is only issued for API flows, not for Browser flows!", "type": "string" } }, "required": [ "session" ], "type": "object" }, "successfulNativeRegistration": { "description": "The Response for Registration Flows via API", "properties": { "continue_with": { "description": "Contains a list of actions, that could follow this flow\n\nIt can, for example, this will contain a reference to the verification flow, created as part of the user's\nregistration or the token of the session.", "items": { "$ref": "#/components/schemas/continueWith" }, "type": "array" }, "identity": { "$ref": "#/components/schemas/identity" }, "session": { "$ref": "#/components/schemas/session" }, "session_token": { "description": "The Session Token\n\nThis field is only set when the session hook is configured as a post-registration hook.\n\nA session token is equivalent to a session cookie, but it can be sent in the HTTP Authorization\nHeader:\n\nAuthorization: bearer ${session-token}\n\nThe session token is only issued for API flows, not for Browser flows!", "type": "string" } }, "required": [ "identity" ], "type": "object" }, "successfulProjectUpdate": { "properties": { "project": { "$ref": "#/components/schemas/project" }, "warnings": { "description": "Import Warnings\n\nNot all configuration items can be imported to the Ory Network. For example,\nsetting the port does not make sense because the Ory Network provides the runtime\nand networking.\n\nThis field contains warnings where configuration keys were found but can not\nbe imported. These keys will be ignored by the Ory Network. This field will help\nyou understand why certain configuration keys might not be respected!", "items": { "$ref": "#/components/schemas/Warning" }, "type": "array" } }, "required": [ "project", "warnings" ], "type": "object" }, "talosRetiredValue": { "description": "TalosRetiredValue is one entry of an Ory Talos retired-value array (retired HMAC\nsecrets or retired issuer URLs). Retired values stay valid for verification\nduring rotation.", "properties": { "expires_at": { "description": "Optional RFC 3339 UTC timestamp after which Talos stops accepting this\nretired value during verification. Omit to never expire.", "example": "2026-08-01T00:00:00Z", "format": "date-time", "type": "string" }, "value": { "description": "The retired secret or issuer URL.", "type": "string" } }, "required": [ "value" ], "type": "object" }, "talosRetiredValues": { "description": "TalosRetiredValues is the list of retired values — retired HMAC secrets or\nretired issuer URLs — for a Talos project. A retired value stays valid for\nverification until its optional expiry passes, so operators can bound how long\nan old credential keeps working after a rotation instead of keeping it forever.\nLegacy bare-string entries are accepted on write and normalized to the object\nform.", "items": { "$ref": "#/components/schemas/talosRetiredValue" }, "type": "array" }, "tokenPagination": { "properties": { "page_size": { "default": 250, "description": "Items per page\n\nThis is the number of items per page to return.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "format": "int64", "maximum": 1000, "minimum": 1, "type": "integer" }, "page_token": { "description": "Next Page Token\n\nThe next page token.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "type": "string" } }, "type": "object" }, "tokenPaginationHeaders": { "properties": { "link": { "description": "The link header contains pagination links.\n\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).\n\nin: header", "type": "string" }, "x-total-count": { "description": "The total number of clients.\n\nin: header", "type": "string" } }, "type": "object" }, "tokenPaginationRequestParameters": { "description": "The `Link` HTTP header contains multiple links (`first`, `next`, `last`, `previous`) formatted as:\n`\u003chttps://{project-slug}.projects.oryapis.com/admin/clients?page_size={limit}\u0026page_token={offset}\u003e; rel=\"{page}\"`\n\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "properties": { "page_size": { "default": 250, "description": "Items per Page\n\nThis is the number of items per page to return.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "format": "int64", "maximum": 500, "minimum": 1, "type": "integer" }, "page_token": { "description": "Next Page Token\n\nThe next page token.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "type": "string" } }, "title": "Pagination Request Parameters", "type": "object" }, "tokenPaginationResponseHeaders": { "description": "The `Link` HTTP header contains multiple links (`first`, `next`, `last`, `previous`) formatted as:\n`\u003chttps://{project-slug}.projects.oryapis.com/admin/clients?page_size={limit}\u0026page_token={offset}\u003e; rel=\"{page}\"`\n\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "properties": { "link": { "description": "The Link HTTP Header\n\nThe `Link` header contains a comma-delimited list of links to the following pages:\n\nfirst: The first page of results.\nnext: The next page of results.\nprev: The previous page of results.\nlast: The last page of results.\n\nPages are omitted if they do not exist. For example, if there is no next page, the `next` link is omitted. Examples:\n\n\u003c/clients?page_size=5\u0026page_token=0\u003e; rel=\"first\",\u003c/clients?page_size=5\u0026page_token=15\u003e; rel=\"next\",\u003c/clients?page_size=5\u0026page_token=5\u003e; rel=\"prev\",\u003c/clients?page_size=5\u0026page_token=20\u003e; rel=\"last\"", "type": "string" }, "x-total-count": { "description": "The X-Total-Count HTTP Header\n\nThe `X-Total-Count` header contains the total number of items in the collection.", "format": "int64", "type": "integer" } }, "title": "Pagination Response Header", "type": "object" }, "trustOAuth2JwtGrantIssuer": { "description": "Trust OAuth2 JWT Bearer Grant Type Issuer Request Body", "properties": { "allow_any_subject": { "description": "The \"allow_any_subject\" indicates that the issuer is allowed to have any principal as the subject of the JWT.", "type": "boolean" }, "expires_at": { "description": "The \"expires_at\" indicates, when grant will expire, so we will reject assertion from \"issuer\" targeting \"subject\".", "format": "date-time", "type": "string" }, "issuer": { "description": "The \"issuer\" identifies the principal that issued the JWT assertion (same as \"iss\" claim in JWT).", "example": "https://jwt-idp.example.com", "type": "string" }, "jwk": { "$ref": "#/components/schemas/jsonWebKey" }, "scope": { "description": "The \"scope\" contains list of scope values (as described in Section 3.3 of OAuth 2.0 [RFC6749])", "example": [ "openid", "offline" ], "items": { "type": "string" }, "type": "array" }, "subject": { "description": "The \"subject\" identifies the principal that is the subject of the JWT.", "example": "mike@example.com", "type": "string" } }, "required": [ "issuer", "scope", "jwk", "expires_at" ], "type": "object" }, "trustedOAuth2JwtGrantIssuer": { "description": "OAuth2 JWT Bearer Grant Type Issuer Trust Relationship", "properties": { "allow_any_subject": { "description": "The \"allow_any_subject\" indicates that the issuer is allowed to have any principal as the subject of the JWT.", "type": "boolean" }, "created_at": { "description": "The \"created_at\" indicates, when grant was created.", "format": "date-time", "type": "string" }, "expires_at": { "description": "The \"expires_at\" indicates, when grant will expire, so we will reject assertion from \"issuer\" targeting \"subject\".", "format": "date-time", "type": "string" }, "id": { "example": "9edc811f-4e28-453c-9b46-4de65f00217f", "type": "string" }, "issuer": { "description": "The \"issuer\" identifies the principal that issued the JWT assertion (same as \"iss\" claim in JWT).", "example": "https://jwt-idp.example.com", "type": "string" }, "public_key": { "$ref": "#/components/schemas/trustedOAuth2JwtGrantJsonWebKey" }, "scope": { "description": "The \"scope\" contains list of scope values (as described in Section 3.3 of OAuth 2.0 [RFC6749])", "example": [ "openid", "offline" ], "items": { "type": "string" }, "type": "array" }, "subject": { "description": "The \"subject\" identifies the principal that is the subject of the JWT.", "example": "mike@example.com", "type": "string" } }, "type": "object" }, "trustedOAuth2JwtGrantIssuers": { "description": "OAuth2 JWT Bearer Grant Type Issuer Trust Relationships", "items": { "$ref": "#/components/schemas/trustedOAuth2JwtGrantIssuer" }, "type": "array" }, "trustedOAuth2JwtGrantJsonWebKey": { "description": "OAuth2 JWT Bearer Grant Type Issuer Trusted JSON Web Key", "properties": { "kid": { "description": "The \"key_id\" is key unique identifier (same as kid header in jws/jwt).", "example": "123e4567-e89b-12d3-a456-426655440000", "type": "string" }, "set": { "description": "The \"set\" is basically a name for a group(set) of keys. Will be the same as \"issuer\" in grant.", "example": "https://jwt-idp.example.com", "type": "string" } }, "type": "object" }, "uiContainer": { "description": "Container represents a HTML Form. The container can work with both HTTP Form and JSON requests", "properties": { "action": { "description": "Action should be used as the form action URL `\u003cform action=\"{{ .Action }}\" method=\"post\"\u003e`.", "type": "string" }, "messages": { "$ref": "#/components/schemas/uiTexts" }, "method": { "description": "Method is the form method (e.g. POST)", "type": "string" }, "nodes": { "$ref": "#/components/schemas/uiNodes" } }, "required": [ "action", "method", "nodes" ], "type": "object" }, "uiNode": { "description": "Nodes are represented as HTML elements or their native UI equivalents. For example,\na node can be an `\u003cimg\u003e` tag, or an `\u003cinput element\u003e` but also `some plain text`.", "properties": { "attributes": { "$ref": "#/components/schemas/uiNodeAttributes" }, "group": { "description": "Group specifies which group (e.g. password authenticator) this node belongs to.\ndefault DefaultGroup\npassword PasswordGroup\noidc OpenIDConnectGroup\nprofile ProfileGroup\nlink LinkGroup\ncode CodeGroup\ntotp TOTPGroup\nlookup_secret LookupGroup\nwebauthn WebAuthnGroup\npasskey PasskeyGroup\nidentifier_first IdentifierFirstGroup\ncaptcha CaptchaGroup\nsaml SAMLGroup\ndeviceauthn DeviceAuthnGroup", "enum": [ "default", "password", "oidc", "profile", "link", "code", "totp", "lookup_secret", "webauthn", "passkey", "identifier_first", "captcha", "saml", "deviceauthn", "oauth2_consent" ], "type": "string", "x-go-enum-desc": "default DefaultGroup\npassword PasswordGroup\noidc OpenIDConnectGroup\nprofile ProfileGroup\nlink LinkGroup\ncode CodeGroup\ntotp TOTPGroup\nlookup_secret LookupGroup\nwebauthn WebAuthnGroup\npasskey PasskeyGroup\nidentifier_first IdentifierFirstGroup\ncaptcha CaptchaGroup\nsaml SAMLGroup\ndeviceauthn DeviceAuthnGroup" }, "messages": { "$ref": "#/components/schemas/uiTexts" }, "meta": { "$ref": "#/components/schemas/uiNodeMeta" }, "type": { "description": "The node's type\ntext Text\ninput Input\nimg Image\na Anchor\nscript Script\ndiv Division", "enum": [ "text", "input", "img", "a", "script", "div" ], "type": "string", "x-go-enum-desc": "text Text\ninput Input\nimg Image\na Anchor\nscript Script\ndiv Division" } }, "required": [ "type", "group", "attributes", "messages", "meta" ], "title": "Node represents a flow's nodes", "type": "object" }, "uiNodeAnchorAttributes": { "properties": { "href": { "description": "The link's href (destination) URL.\n\nformat: uri", "type": "string" }, "id": { "description": "A unique identifier", "type": "string" }, "node_type": { "description": "NodeType represents this node's types. It is a mirror of `node.type` and\nis primarily used to allow compatibility with OpenAPI 3.0. In this struct it technically always is \"a\".\ntext Text\ninput Input\nimg Image\na Anchor\nscript Script\ndiv Division", "enum": [ "a" ], "type": "string", "x-go-enum-desc": "text Text\ninput Input\nimg Image\na Anchor\nscript Script\ndiv Division" }, "title": { "$ref": "#/components/schemas/uiText" } }, "required": [ "href", "title", "id", "node_type" ], "title": "AnchorAttributes represents the attributes of an anchor node.", "type": "object" }, "uiNodeAttributes": { "discriminator": { "mapping": { "a": "#/components/schemas/uiNodeAnchorAttributes", "div": "#/components/schemas/uiNodeDivisionAttributes", "img": "#/components/schemas/uiNodeImageAttributes", "input": "#/components/schemas/uiNodeInputAttributes", "script": "#/components/schemas/uiNodeScriptAttributes", "text": "#/components/schemas/uiNodeTextAttributes" }, "propertyName": "node_type" }, "oneOf": [ { "$ref": "#/components/schemas/uiNodeInputAttributes" }, { "$ref": "#/components/schemas/uiNodeTextAttributes" }, { "$ref": "#/components/schemas/uiNodeImageAttributes" }, { "$ref": "#/components/schemas/uiNodeAnchorAttributes" }, { "$ref": "#/components/schemas/uiNodeScriptAttributes" }, { "$ref": "#/components/schemas/uiNodeDivisionAttributes" } ], "title": "Attributes represents a list of attributes (e.g. `href=\"foo\"` for links)." }, "uiNodeDivisionAttributes": { "description": "Division sections are used for interactive widgets that require a hook in the DOM / view.", "properties": { "class": { "description": "A classname that should be rendered into the DOM.", "type": "string" }, "data": { "additionalProperties": { "type": "string" }, "description": "Data is a map of key-value pairs that are passed to the division.\n\nThey may be used for `data-...` attributes.", "type": "object" }, "id": { "description": "A unique identifier", "type": "string" }, "node_type": { "description": "NodeType represents this node's type. It is a mirror of `node.type` and\nis primarily used to allow compatibility with OpenAPI 3.0. In this struct it technically always is \"script\".\ntext Text\ninput Input\nimg Image\na Anchor\nscript Script\ndiv Division", "enum": [ "div" ], "type": "string", "x-go-enum-desc": "text Text\ninput Input\nimg Image\na Anchor\nscript Script\ndiv Division" } }, "required": [ "id", "node_type" ], "title": "DivisionAttributes represent a division section.", "type": "object" }, "uiNodeImageAttributes": { "properties": { "height": { "description": "Height of the image", "format": "int64", "type": "integer" }, "id": { "description": "A unique identifier", "type": "string" }, "node_type": { "description": "NodeType represents this node's types. It is a mirror of `node.type` and\nis primarily used to allow compatibility with OpenAPI 3.0. In this struct it technically always is \"img\".\ntext Text\ninput Input\nimg Image\na Anchor\nscript Script\ndiv Division", "enum": [ "img" ], "type": "string", "x-go-enum-desc": "text Text\ninput Input\nimg Image\na Anchor\nscript Script\ndiv Division" }, "src": { "description": "The image's source URL.\n\nformat: uri", "type": "string" }, "width": { "description": "Width of the image", "format": "int64", "type": "integer" } }, "required": [ "src", "id", "width", "height", "node_type" ], "title": "ImageAttributes represents the attributes of an image node.", "type": "object" }, "uiNodeInputAttributes": { "description": "InputAttributes represents the attributes of an input node", "properties": { "autocomplete": { "description": "The autocomplete attribute for the input.\nemail InputAttributeAutocompleteEmail\ntel InputAttributeAutocompleteTel\nurl InputAttributeAutocompleteUrl\ncurrent-password InputAttributeAutocompleteCurrentPassword\nnew-password InputAttributeAutocompleteNewPassword\none-time-code InputAttributeAutocompleteOneTimeCode\nusername InputAttributeAutocompleteUsername\nusername webauthn InputAttributeAutocompleteUsernameWebauthn", "enum": [ "email", "tel", "url", "current-password", "new-password", "one-time-code", "username", "username webauthn" ], "type": "string", "x-go-enum-desc": "email InputAttributeAutocompleteEmail\ntel InputAttributeAutocompleteTel\nurl InputAttributeAutocompleteUrl\ncurrent-password InputAttributeAutocompleteCurrentPassword\nnew-password InputAttributeAutocompleteNewPassword\none-time-code InputAttributeAutocompleteOneTimeCode\nusername InputAttributeAutocompleteUsername\nusername webauthn InputAttributeAutocompleteUsernameWebauthn" }, "disabled": { "description": "Sets the input's disabled field to true or false.", "type": "boolean" }, "label": { "$ref": "#/components/schemas/uiText" }, "maxlength": { "description": "MaxLength may contain the input's maximum length.", "format": "int64", "type": "integer" }, "name": { "description": "The input's element name.", "type": "string" }, "node_type": { "description": "NodeType represents this node's types. It is a mirror of `node.type` and\nis primarily used to allow compatibility with OpenAPI 3.0. In this struct it technically always is \"input\".\ntext Text\ninput Input\nimg Image\na Anchor\nscript Script\ndiv Division", "enum": [ "input" ], "type": "string", "x-go-enum-desc": "text Text\ninput Input\nimg Image\na Anchor\nscript Script\ndiv Division" }, "onclick": { "description": "OnClick may contain javascript which should be executed on click. This is primarily\nused for WebAuthn.\n\nDeprecated: Using OnClick requires the use of eval() which is a security risk. Use OnClickTrigger instead.", "type": "string" }, "onclickTrigger": { "description": "OnClickTrigger may contain a WebAuthn trigger which should be executed on click.\n\nThe trigger maps to a JavaScript function provided by Ory, which triggers actions such as PassKey registration or login.\noryWebAuthnRegistration WebAuthnTriggersWebAuthnRegistration\noryWebAuthnLogin WebAuthnTriggersWebAuthnLogin\noryPasskeyLogin WebAuthnTriggersPasskeyLogin\noryPasskeyLoginAutocompleteInit WebAuthnTriggersPasskeyLoginAutocompleteInit\noryPasskeyRegistration WebAuthnTriggersPasskeyRegistration\noryPasskeySettingsRegistration WebAuthnTriggersPasskeySettingsRegistration", "enum": [ "oryWebAuthnRegistration", "oryWebAuthnLogin", "oryPasskeyLogin", "oryPasskeyLoginAutocompleteInit", "oryPasskeyRegistration", "oryPasskeySettingsRegistration" ], "type": "string", "x-go-enum-desc": "oryWebAuthnRegistration WebAuthnTriggersWebAuthnRegistration\noryWebAuthnLogin WebAuthnTriggersWebAuthnLogin\noryPasskeyLogin WebAuthnTriggersPasskeyLogin\noryPasskeyLoginAutocompleteInit WebAuthnTriggersPasskeyLoginAutocompleteInit\noryPasskeyRegistration WebAuthnTriggersPasskeyRegistration\noryPasskeySettingsRegistration WebAuthnTriggersPasskeySettingsRegistration" }, "onload": { "description": "OnLoad may contain javascript which should be executed on load. This is primarily\nused for WebAuthn.\n\nDeprecated: Using OnLoad requires the use of eval() which is a security risk. Use OnLoadTrigger instead.", "type": "string" }, "onloadTrigger": { "description": "OnLoadTrigger may contain a WebAuthn trigger which should be executed on load.\n\nThe trigger maps to a JavaScript function provided by Ory, which triggers actions such as PassKey registration or login.\noryWebAuthnRegistration WebAuthnTriggersWebAuthnRegistration\noryWebAuthnLogin WebAuthnTriggersWebAuthnLogin\noryPasskeyLogin WebAuthnTriggersPasskeyLogin\noryPasskeyLoginAutocompleteInit WebAuthnTriggersPasskeyLoginAutocompleteInit\noryPasskeyRegistration WebAuthnTriggersPasskeyRegistration\noryPasskeySettingsRegistration WebAuthnTriggersPasskeySettingsRegistration", "enum": [ "oryWebAuthnRegistration", "oryWebAuthnLogin", "oryPasskeyLogin", "oryPasskeyLoginAutocompleteInit", "oryPasskeyRegistration", "oryPasskeySettingsRegistration" ], "type": "string", "x-go-enum-desc": "oryWebAuthnRegistration WebAuthnTriggersWebAuthnRegistration\noryWebAuthnLogin WebAuthnTriggersWebAuthnLogin\noryPasskeyLogin WebAuthnTriggersPasskeyLogin\noryPasskeyLoginAutocompleteInit WebAuthnTriggersPasskeyLoginAutocompleteInit\noryPasskeyRegistration WebAuthnTriggersPasskeyRegistration\noryPasskeySettingsRegistration WebAuthnTriggersPasskeySettingsRegistration" }, "options": { "description": "The allowed values for the input when the underlying JSON schema\ndefines an `enum`. When present, clients should render the field as a\nselect/dropdown rather than a free-form text input. When absent,\nclients continue to render a plain text input, so this field is\nbackward compatible with UIs that do not look at it.", "items": { "$ref": "#/components/schemas/uiNodeInputAttributesOption" }, "type": "array" }, "pattern": { "description": "The input's pattern.", "type": "string" }, "required": { "description": "Mark this input field as required.", "type": "boolean" }, "type": { "description": "The input's element type.\ntext InputAttributeTypeText\npassword InputAttributeTypePassword\nnumber InputAttributeTypeNumber\ncheckbox InputAttributeTypeCheckbox\nhidden InputAttributeTypeHidden\nemail InputAttributeTypeEmail\ntel InputAttributeTypeTel\nsubmit InputAttributeTypeSubmit\nbutton InputAttributeTypeButton\ndatetime-local InputAttributeTypeDateTimeLocal\ndate InputAttributeTypeDate\nurl InputAttributeTypeURI", "enum": [ "text", "password", "number", "checkbox", "hidden", "email", "tel", "submit", "button", "datetime-local", "date", "url" ], "type": "string", "x-go-enum-desc": "text InputAttributeTypeText\npassword InputAttributeTypePassword\nnumber InputAttributeTypeNumber\ncheckbox InputAttributeTypeCheckbox\nhidden InputAttributeTypeHidden\nemail InputAttributeTypeEmail\ntel InputAttributeTypeTel\nsubmit InputAttributeTypeSubmit\nbutton InputAttributeTypeButton\ndatetime-local InputAttributeTypeDateTimeLocal\ndate InputAttributeTypeDate\nurl InputAttributeTypeURI" }, "value": { "description": "The input's value.", "nullable": true } }, "required": [ "name", "type", "disabled", "node_type" ], "type": "object" }, "uiNodeInputAttributesOption": { "description": "Represents a single selectable value for an input whose JSON schema\ndefined an `enum`. The value is always a scalar JSON type (string, number,\nor boolean) serialized verbatim from the schema. When present, clients\nshould render the parent input as a select/dropdown.", "properties": { "value": { "description": "The value that will be submitted when this option is picked.\nIt is serialized verbatim from the JSON schema `enum` entry, so it is\nalways a scalar JSON value (string, number, or boolean)." } }, "required": [ "value" ], "type": "object" }, "uiNodeMeta": { "description": "This might include a label and other information that can optionally\nbe used to render UIs.", "properties": { "label": { "$ref": "#/components/schemas/uiText" } }, "title": "A Node's Meta Information", "type": "object" }, "uiNodeScriptAttributes": { "properties": { "async": { "description": "The script async type", "type": "boolean" }, "crossorigin": { "description": "The script cross origin policy", "type": "string" }, "id": { "description": "A unique identifier", "type": "string" }, "integrity": { "description": "The script's integrity hash", "type": "string" }, "node_type": { "description": "NodeType represents this node's types. It is a mirror of `node.type` and\nis primarily used to allow compatibility with OpenAPI 3.0. In this struct it technically always is \"script\".\ntext Text\ninput Input\nimg Image\na Anchor\nscript Script\ndiv Division", "enum": [ "script" ], "type": "string", "x-go-enum-desc": "text Text\ninput Input\nimg Image\na Anchor\nscript Script\ndiv Division" }, "nonce": { "description": "Nonce for CSP\n\nA nonce you may want to use to improve your Content Security Policy.\nYou do not have to use this value but if you want to improve your CSP\npolicies you may use it. You can also choose to use your own nonce value!", "type": "string" }, "referrerpolicy": { "description": "The script referrer policy", "type": "string" }, "src": { "description": "The script source", "type": "string" }, "type": { "description": "The script MIME type", "type": "string" } }, "required": [ "src", "async", "referrerpolicy", "crossorigin", "integrity", "type", "id", "nonce", "node_type" ], "title": "ScriptAttributes represent script nodes which load javascript.", "type": "object" }, "uiNodeTextAttributes": { "properties": { "id": { "description": "A unique identifier", "type": "string" }, "node_type": { "description": "NodeType represents this node's types. It is a mirror of `node.type` and\nis primarily used to allow compatibility with OpenAPI 3.0. In this struct it technically always is \"text\".\ntext Text\ninput Input\nimg Image\na Anchor\nscript Script\ndiv Division", "enum": [ "text" ], "type": "string", "x-go-enum-desc": "text Text\ninput Input\nimg Image\na Anchor\nscript Script\ndiv Division" }, "text": { "$ref": "#/components/schemas/uiText" } }, "required": [ "text", "id", "node_type" ], "title": "TextAttributes represents the attributes of a text node.", "type": "object" }, "uiNodes": { "items": { "$ref": "#/components/schemas/uiNode" }, "type": "array" }, "uiText": { "properties": { "context": { "description": "The message's context. Useful when customizing messages.", "type": "object" }, "id": { "$ref": "#/components/schemas/ID" }, "text": { "description": "The message text. Written in american english.", "type": "string" }, "type": { "description": "The message type.\ninfo Info\nerror Error\nsuccess Success", "enum": [ "info", "error", "success" ], "type": "string", "x-go-enum-desc": "info Info\nerror Error\nsuccess Success" } }, "required": [ "id", "text", "type" ], "type": "object" }, "uiTexts": { "items": { "$ref": "#/components/schemas/uiText" }, "type": "array" }, "unexpectedError": { "type": "string" }, "updateIdentityBody": { "description": "Update Identity Body", "properties": { "credentials": { "$ref": "#/components/schemas/identityWithCredentials" }, "external_id": { "description": "ExternalID is an optional external ID of the identity. This is used to link\nthe identity to an external system. If set, the external ID must be unique\nacross all identities.", "type": "string" }, "metadata_admin": { "description": "Store metadata about the user which is only accessible through admin APIs such as `GET /admin/identities/\u003cid\u003e`." }, "metadata_public": { "description": "Store metadata about the identity which the identity itself can see when calling for example the\nsession endpoint. Do not store sensitive information (e.g. credit score) about the identity in this field." }, "region": { "description": "Region is the Ory Network region this identity is homed in. Optional;\nomit to leave the current region unchanged.\neu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global", "enum": [ "eu-central", "asia-northeast", "us-east", "us-west", "eu", "asia", "us", "global" ], "type": "string", "x-go-enum-desc": "eu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global" }, "schema_id": { "description": "SchemaID is the ID of the JSON Schema to be used for validating the identity's traits. If set\nwill update the Identity's SchemaID.", "type": "string" }, "state": { "description": "State is the identity's state.\nactive StateActive\ninactive StateInactive", "enum": [ "active", "inactive" ], "type": "string", "x-go-enum-desc": "active StateActive\ninactive StateInactive" }, "traits": { "description": "Traits represent an identity's traits. The identity is able to create, modify, and delete traits\nin a self-service manner. The input will always be validated against the JSON Schema defined\nin `schema_id`.", "type": "object" } }, "required": [ "schema_id", "traits", "state" ], "type": "object" }, "updateLoginFlowBody": { "discriminator": { "mapping": { "code": "#/components/schemas/updateLoginFlowWithCodeMethod", "deviceauthn": "#/components/schemas/updateLoginFlowWithDeviceAuthnMethod", "identifier_first": "#/components/schemas/updateLoginFlowWithIdentifierFirstMethod", "lookup_secret": "#/components/schemas/updateLoginFlowWithLookupSecretMethod", "oidc": "#/components/schemas/updateLoginFlowWithOidcMethod", "passkey": "#/components/schemas/updateLoginFlowWithPasskeyMethod", "password": "#/components/schemas/updateLoginFlowWithPasswordMethod", "saml": "#/components/schemas/updateLoginFlowWithSamlMethod", "totp": "#/components/schemas/updateLoginFlowWithTotpMethod", "webauthn": "#/components/schemas/updateLoginFlowWithWebAuthnMethod" }, "propertyName": "method" }, "oneOf": [ { "$ref": "#/components/schemas/updateLoginFlowWithPasswordMethod" }, { "$ref": "#/components/schemas/updateLoginFlowWithOidcMethod" }, { "$ref": "#/components/schemas/updateLoginFlowWithSamlMethod" }, { "$ref": "#/components/schemas/updateLoginFlowWithTotpMethod" }, { "$ref": "#/components/schemas/updateLoginFlowWithWebAuthnMethod" }, { "$ref": "#/components/schemas/updateLoginFlowWithDeviceAuthnMethod" }, { "$ref": "#/components/schemas/updateLoginFlowWithLookupSecretMethod" }, { "$ref": "#/components/schemas/updateLoginFlowWithCodeMethod" }, { "$ref": "#/components/schemas/updateLoginFlowWithPasskeyMethod" }, { "$ref": "#/components/schemas/updateLoginFlowWithIdentifierFirstMethod" } ] }, "updateLoginFlowWithCodeMethod": { "description": "Update Login flow using the code method", "properties": { "address": { "description": "Address is the address to send the code to, in case that there are multiple addresses. This field\nis only used in two-factor flows and is ineffective for passwordless flows.", "type": "string" }, "code": { "description": "Code is the 6 digits code sent to the user", "type": "string" }, "csrf_token": { "description": "CSRFToken is the anti-CSRF token", "type": "string" }, "identifier": { "description": "Identifier is the code identifier\nThe identifier requires that the user has already completed the registration or settings with code flow.", "type": "string" }, "method": { "description": "Method should be set to \"code\" when logging in using the code strategy.", "type": "string" }, "resend": { "description": "Resend is set when the user wants to resend the code", "type": "string" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "method", "csrf_token" ], "type": "object" }, "updateLoginFlowWithDeviceAuthnMethod": { "description": "Log in by proving possession of an enrolled device key. The device signs\nthe challenge nonce found in the login flow's hidden `deviceauthn_nonce`\nUI node; a PIN-protected key additionally proves knowledge of the PIN via\n`pin_proof`.\n\nUse it for step-up in a login flow created with `aal=aal2`, or as the sole\nfirst factor (a one-step AAL2 login, for keys with \"pin\" or \"platform\" user\nverification) when the project's deviceauthn first_factor setting is\nenabled. Only API (native) flows support this method.", "properties": { "client_key_id": { "description": "The client_key_id of the enrolled key to authenticate with.\n\nIt is the key's deterministic fingerprint: the lowercase-hex SHA-256 of\nthe device public key in PKIX, ASN.1 DER (SubjectPublicKeyInfo) form,\nwhich the device can recompute locally after enrollment. Keys enrolled\nbefore the server derived the id use their original client-chosen value.", "type": "string" }, "method": { "description": "Method should be set to \"deviceauthn\" when logging in using the DeviceAuthn strategy.", "type": "string" }, "pin_proof": { "description": "The proof of the PIN, required if and only if the key is PIN-protected.\n\nTo compute it:\n\n1. Recover the 32-byte pin_secret on the device. It was delivered\nHPKE-sealed exactly once at enrollment or rotation and is bound to the\nuser's PIN locally.\n2. Compute HMAC-SHA256, keyed with the pin_secret, over the\nconcatenation of three byte strings: the ASCII domain prefix\n\"ory/deviceauthn/pin-proof/v1\", the client_key_id exactly as sent (its\n64-character lowercase-hex ASCII form, not hex-decoded), and the raw\nchallenge bytes also covered by `signature`.\n3. Submit the 32-byte MAC output.\n\nThe proof shows knowledge of the PIN without transmitting the PIN or the\npin_secret. After too many wrong attempts (pin_max_attempts, default 5)\nthe key locks and can no longer be used to log in.", "format": "byte", "type": "string", "writeOnly": true }, "signature": { "description": "The device's signature over the challenge nonce carried by the login\nflow's hidden `deviceauthn_nonce` UI node.\n\nTo compute it:\n\n1. Base64-decode the `deviceauthn_nonce` node's value and parse the\nresult as JSON.\n2. Base64-decode the JSON's `nonce` field. The decoded raw bytes are the\nchallenge.\n3. On Android, sign the challenge with the enrolled hardware-backed key\nusing `Signature.getInstance(\"SHA256withECDSA\")` (it hashes internally)\nand submit the resulting ASN.1 DER-encoded ECDSA signature. On iOS, call\n`DCAppAttestService.generateAssertion`, passing the raw challenge bytes\nas the `clientDataHash` argument — do not hash them again — and submit\nthe returned CBOR-encoded App Attest assertion unchanged.", "format": "byte", "type": "string" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "method", "client_key_id", "signature" ], "title": "Update Login Flow with DeviceAuthn Method", "type": "object" }, "updateLoginFlowWithIdentifierFirstMethod": { "description": "Update Login Flow with Multi-Step Method", "properties": { "csrf_token": { "description": "Sending the anti-csrf token is only required for browser login flows.", "type": "string" }, "identifier": { "description": "Identifier is the email or username of the user trying to log in.", "type": "string" }, "method": { "description": "Method should be set to \"password\" when logging in using the identifier and password strategy.", "type": "string" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "method", "identifier" ], "type": "object" }, "updateLoginFlowWithLookupSecretMethod": { "description": "Update Login Flow with Lookup Secret Method", "properties": { "csrf_token": { "description": "Sending the anti-csrf token is only required for browser login flows.", "type": "string" }, "lookup_secret": { "description": "The lookup secret.", "type": "string" }, "method": { "description": "Method should be set to \"lookup_secret\" when logging in using the lookup_secret strategy.", "type": "string" } }, "required": [ "method", "lookup_secret" ], "type": "object" }, "updateLoginFlowWithOidcMethod": { "description": "Update Login Flow with OpenID Connect Method", "properties": { "csrf_token": { "description": "The CSRF Token", "type": "string" }, "id_token": { "description": "IDToken is an optional id token provided by an OIDC provider\n\nIf submitted, it is verified using the OIDC provider's public key set and the claims are used to populate\nthe OIDC credentials of the identity.\nIf the OIDC provider does not store additional claims (such as name, etc.) in the IDToken itself, you can use\nthe `traits` field to populate the identity's traits. Note, that Apple only includes the users email in the IDToken.\n\nSupported providers are\nApple\nGoogle", "type": "string" }, "id_token_nonce": { "description": "IDTokenNonce is the nonce, used when generating the IDToken.\nIf the provider supports nonce validation, the nonce will be validated against this value and required.", "type": "string" }, "method": { "description": "Method to use\n\nThis field must be set to `oidc` when using the oidc method.", "type": "string" }, "provider": { "description": "The provider to register with", "type": "string" }, "traits": { "description": "The identity traits. This is a placeholder for the registration flow.", "type": "object" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" }, "upstream_parameters": { "description": "UpstreamParameters are the parameters that are passed to the upstream identity provider.\n\nThese parameters are optional and depend on what the upstream identity provider supports.\nSupported parameters are:\n`hd` (string): The `hd` parameter limits the login/registration process to a Google Organization, e.g. `mycollege.edu`.\n`prompt` (string): The `prompt` specifies whether the Authorization Server prompts the End-User for reauthentication and consent, e.g. `select_account`.\n`acr_values` (string): The `acr_values` specifies the Authentication Context Class Reference values for the authorization request.", "type": "object" } }, "required": [ "provider", "method" ], "type": "object" }, "updateLoginFlowWithPasskeyMethod": { "description": "Update Login Flow with Passkey Method", "properties": { "csrf_token": { "description": "Sending the anti-csrf token is only required for browser login flows.", "type": "string" }, "method": { "description": "Method should be set to \"passkey\" when logging in using the Passkey strategy.", "type": "string" }, "passkey_login": { "description": "Login a WebAuthn Security Key\n\nThis must contain the ID of the WebAuthN connection.", "type": "string" } }, "required": [ "method" ], "type": "object" }, "updateLoginFlowWithPasswordMethod": { "description": "Update Login Flow with Password Method", "properties": { "csrf_token": { "description": "Sending the anti-csrf token is only required for browser login flows.", "type": "string" }, "identifier": { "description": "Identifier is the email or username of the user trying to log in.", "type": "string" }, "method": { "description": "Method should be set to \"password\" when logging in using the identifier and password strategy.", "type": "string" }, "password": { "description": "The user's password.", "type": "string" }, "password_identifier": { "description": "Identifier is the email or username of the user trying to log in.\nThis field is deprecated!", "type": "string" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "method", "password", "identifier" ], "type": "object" }, "updateLoginFlowWithSamlMethod": { "description": "Update login flow using SAML", "properties": { "csrf_token": { "description": "The CSRF Token", "type": "string" }, "method": { "description": "Method to use\n\nThis field must be set to `saml` when using the saml method.", "type": "string" }, "provider": { "description": "The provider to register with", "type": "string" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "provider", "method" ], "type": "object" }, "updateLoginFlowWithTotpMethod": { "description": "Update Login Flow with TOTP Method", "properties": { "csrf_token": { "description": "Sending the anti-csrf token is only required for browser login flows.", "type": "string" }, "method": { "description": "Method should be set to \"totp\" when logging in using the TOTP strategy.", "type": "string" }, "totp_code": { "description": "The TOTP code.", "type": "string" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "method", "totp_code" ], "type": "object" }, "updateLoginFlowWithWebAuthnMethod": { "description": "Update Login Flow with WebAuthn Method", "properties": { "csrf_token": { "description": "Sending the anti-csrf token is only required for browser login flows.", "type": "string" }, "identifier": { "description": "Identifier is the email or username of the user trying to log in.", "type": "string" }, "method": { "description": "Method should be set to \"webAuthn\" when logging in using the WebAuthn strategy.", "type": "string" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" }, "webauthn_login": { "description": "Login a WebAuthn Security Key\n\nThis must contain the ID of the WebAuthN connection.", "type": "string" } }, "required": [ "identifier", "method" ], "type": "object" }, "updateOrganizationOnboardingPortalLinkBody": { "properties": { "enable_scim": { "description": "Feature flag to enable SCIM configuration", "type": "boolean" }, "enable_sso": { "description": "Feature flag to enable SSO configuration", "type": "boolean" }, "expires_at": { "$ref": "#/components/schemas/Time" } }, "required": [ "enable_sso", "enable_scim" ], "type": "object" }, "updateRecoveryFlowBody": { "description": "Update Recovery Flow Request Body", "discriminator": { "mapping": { "code": "#/components/schemas/updateRecoveryFlowWithCodeMethod", "link": "#/components/schemas/updateRecoveryFlowWithLinkMethod" }, "propertyName": "method" }, "oneOf": [ { "$ref": "#/components/schemas/updateRecoveryFlowWithLinkMethod" }, { "$ref": "#/components/schemas/updateRecoveryFlowWithCodeMethod" } ] }, "updateRecoveryFlowWithCodeMethod": { "description": "Update Recovery Flow with Code Method", "properties": { "code": { "description": "Code from the recovery email\n\nIf you want to submit a code, use this field, but make sure to _not_ include the email field, as well.", "type": "string" }, "csrf_token": { "description": "Sending the anti-csrf token is only required for browser login flows.", "type": "string" }, "email": { "description": "The email address of the account to recover\n\nIf the email belongs to a valid account, a recovery email will be sent.\n\nIf you want to notify the email address if the account does not exist, see\nthe [notify_unknown_recipients flag](https://www.ory.com/docs/kratos/self-service/flows/account-recovery-password-reset#attempted-recovery-notifications)\n\nIf a code was already sent, including this field in the payload will invalidate the sent code and re-send a new code.\n\nformat: email", "type": "string" }, "method": { "description": "Method is the method that should be used for this recovery flow\n\nAllowed values are `link` and `code`.\nlink RecoveryStrategyLink\ncode RecoveryStrategyCode", "enum": [ "link", "code" ], "type": "string", "x-go-enum-desc": "link RecoveryStrategyLink\ncode RecoveryStrategyCode" }, "recovery_address": { "description": "A recovery address that is registered for the user.\nIt can be an email, a phone number (to receive the code via SMS), etc.\nUsed in RecoveryV2.", "type": "string" }, "recovery_confirm_address": { "description": "If there are multiple recovery addresses registered for the user, and the initially provided address\nis different from the address chosen when the choice (of masked addresses) is presented, then we need to make sure\nthat the user actually knows the full address to avoid information exfiltration, so we ask for the full address.\nUsed in RecoveryV2.", "type": "string" }, "recovery_select_address": { "description": "If there are multiple addresses registered for the user, a choice is presented and this field\nstores the result of this choice.\nAddresses are 'masked' (never sent in full to the client and shown partially in the UI) since at this point in the recovery flow,\nthe user has not yet proven that it knows the full address and we want to avoid\ninformation exfiltration.\nSo for all intents and purposes, the value of this field should be treated as an opaque identifier.\nUsed in RecoveryV2.", "type": "string" }, "screen": { "description": "Set to \"previous\" to go back in the flow, meaningfully.\nUsed in RecoveryV2.", "type": "string" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "method" ], "type": "object" }, "updateRecoveryFlowWithLinkMethod": { "description": "Update Recovery Flow with Link Method", "properties": { "csrf_token": { "description": "Sending the anti-csrf token is only required for browser login flows.", "type": "string" }, "email": { "description": "Email to Recover\n\nNeeds to be set when initiating the flow. If the email is a registered\nrecovery email, a recovery link will be sent. If the email is not known,\nan email with details on what happened will be sent instead.\n\nformat: email", "type": "string" }, "method": { "description": "Method is the method that should be used for this recovery flow\n\nAllowed values are `link` and `code`\nlink RecoveryStrategyLink\ncode RecoveryStrategyCode", "enum": [ "link", "code" ], "type": "string", "x-go-enum-desc": "link RecoveryStrategyLink\ncode RecoveryStrategyCode" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "email", "method" ], "type": "object" }, "updateRegistrationFlowBody": { "description": "Update Registration Request Body", "discriminator": { "mapping": { "code": "#/components/schemas/updateRegistrationFlowWithCodeMethod", "oidc": "#/components/schemas/updateRegistrationFlowWithOidcMethod", "passkey": "#/components/schemas/updateRegistrationFlowWithPasskeyMethod", "password": "#/components/schemas/updateRegistrationFlowWithPasswordMethod", "profile": "#/components/schemas/updateRegistrationFlowWithProfileMethod", "saml": "#/components/schemas/updateRegistrationFlowWithSamlMethod", "webauthn": "#/components/schemas/updateRegistrationFlowWithWebAuthnMethod" }, "propertyName": "method" }, "oneOf": [ { "$ref": "#/components/schemas/updateRegistrationFlowWithPasswordMethod" }, { "$ref": "#/components/schemas/updateRegistrationFlowWithOidcMethod" }, { "$ref": "#/components/schemas/updateRegistrationFlowWithSamlMethod" }, { "$ref": "#/components/schemas/updateRegistrationFlowWithWebAuthnMethod" }, { "$ref": "#/components/schemas/updateRegistrationFlowWithCodeMethod" }, { "$ref": "#/components/schemas/updateRegistrationFlowWithPasskeyMethod" }, { "$ref": "#/components/schemas/updateRegistrationFlowWithProfileMethod" } ] }, "updateRegistrationFlowWithCodeMethod": { "description": "Update Registration Flow with Code Method", "properties": { "code": { "description": "The OTP Code sent to the user", "type": "string" }, "csrf_token": { "description": "The CSRF Token", "type": "string" }, "method": { "description": "Method to use\n\nThis field must be set to `code` when using the code method.", "type": "string" }, "resend": { "description": "Resend restarts the flow with a new code", "type": "string" }, "traits": { "description": "The identity's traits", "type": "object" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "traits", "method" ], "type": "object" }, "updateRegistrationFlowWithOidcMethod": { "description": "Update Registration Flow with OpenID Connect Method", "properties": { "csrf_token": { "description": "The CSRF Token", "type": "string" }, "id_token": { "description": "IDToken is an optional id token provided by an OIDC provider\n\nIf submitted, it is verified using the OIDC provider's public key set and the claims are used to populate\nthe OIDC credentials of the identity.\nIf the OIDC provider does not store additional claims (such as name, etc.) in the IDToken itself, you can use\nthe `traits` field to populate the identity's traits. Note, that Apple only includes the users email in the IDToken.\n\nSupported providers are\nApple\nGoogle", "type": "string" }, "id_token_nonce": { "description": "IDTokenNonce is the nonce, used when generating the IDToken.\nIf the provider supports nonce validation, the nonce will be validated against this value and is required.", "type": "string" }, "method": { "description": "Method to use\n\nThis field must be set to `oidc` when using the oidc method.", "type": "string" }, "provider": { "description": "The provider to register with", "type": "string" }, "traits": { "description": "The identity traits", "type": "object" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" }, "upstream_parameters": { "description": "UpstreamParameters are the parameters that are passed to the upstream identity provider.\n\nThese parameters are optional and depend on what the upstream identity provider supports.\nSupported parameters are:\n`hd` (string): The `hd` parameter limits the login/registration process to a Google Organization, e.g. `mycollege.edu`.\n`prompt` (string): The `prompt` specifies whether the Authorization Server prompts the End-User for reauthentication and consent, e.g. `select_account`.\n`acr_values` (string): The `acr_values` specifies the Authentication Context Class Reference values for the authorization request.", "type": "object" } }, "required": [ "provider", "method" ], "type": "object" }, "updateRegistrationFlowWithPasskeyMethod": { "description": "Update Registration Flow with Passkey Method", "properties": { "csrf_token": { "description": "CSRFToken is the anti-CSRF token", "type": "string" }, "method": { "description": "Method\n\nShould be set to \"passkey\" when trying to add, update, or remove a Passkey.", "type": "string" }, "passkey_register": { "description": "Register a WebAuthn Security Key\n\nIt is expected that the JSON returned by the WebAuthn registration process\nis included here.", "type": "string" }, "traits": { "description": "The identity's traits", "type": "object" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "traits", "method" ], "type": "object" }, "updateRegistrationFlowWithPasswordMethod": { "description": "Update Registration Flow with Password Method", "properties": { "csrf_token": { "description": "The CSRF Token", "type": "string" }, "method": { "description": "Method to use\n\nThis field must be set to `password` when using the password method.", "type": "string" }, "password": { "description": "Password to sign the user up with", "type": "string" }, "traits": { "description": "The identity's traits", "type": "object" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "password", "traits", "method" ], "type": "object" }, "updateRegistrationFlowWithProfileMethod": { "description": "Update Registration Flow with Profile Method", "properties": { "csrf_token": { "description": "The Anti-CSRF Token\n\nThis token is only required when performing browser flows.", "type": "string" }, "method": { "description": "Method\n\nShould be set to profile when trying to update a profile.", "type": "string" }, "screen": { "description": "Screen requests navigation to a previous screen.\n\nThis must be set to credential-selection to go back to the credential\nselection screen.\ncredential-selection RegistrationScreenCredentialSelection nolint:gosec // not a credential\nprevious RegistrationScreenPrevious", "enum": [ "credential-selection", "previous" ], "type": "string", "x-go-enum-desc": "credential-selection RegistrationScreenCredentialSelection nolint:gosec // not a credential\nprevious RegistrationScreenPrevious" }, "traits": { "description": "Traits\n\nThe identity's traits.", "type": "object" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "traits", "method" ], "type": "object" }, "updateRegistrationFlowWithSamlMethod": { "description": "Update registration flow using SAML", "properties": { "csrf_token": { "description": "The CSRF Token", "type": "string" }, "method": { "description": "Method to use\n\nThis field must be set to `saml` when using the saml method.", "type": "string" }, "provider": { "description": "The provider to register with", "type": "string" }, "traits": { "description": "The identity traits", "type": "object" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "provider", "method" ], "type": "object" }, "updateRegistrationFlowWithWebAuthnMethod": { "description": "Update Registration Flow with WebAuthn Method", "properties": { "csrf_token": { "description": "CSRFToken is the anti-CSRF token", "type": "string" }, "method": { "description": "Method\n\nShould be set to \"webauthn\" when trying to add, update, or remove a webAuthn pairing.", "type": "string" }, "traits": { "description": "The identity's traits", "type": "object" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" }, "webauthn_register": { "description": "Register a WebAuthn Security Key\n\nIt is expected that the JSON returned by the WebAuthn registration process\nis included here.", "type": "string" }, "webauthn_register_displayname": { "description": "Name of the WebAuthn Security Key to be Added\n\nA human-readable name for the security key which will be added.", "type": "string" } }, "required": [ "traits", "method" ], "type": "object" }, "updateSettingsFlowBody": { "description": "Update Settings Flow Request Body", "discriminator": { "mapping": { "deviceauthn": "#/components/schemas/updateSettingsFlowWithDeviceAuthnMethod", "lookup_secret": "#/components/schemas/updateSettingsFlowWithLookupMethod", "oidc": "#/components/schemas/updateSettingsFlowWithOidcMethod", "passkey": "#/components/schemas/updateSettingsFlowWithPasskeyMethod", "password": "#/components/schemas/updateSettingsFlowWithPasswordMethod", "profile": "#/components/schemas/updateSettingsFlowWithProfileMethod", "saml": "#/components/schemas/updateSettingsFlowWithSamlMethod", "totp": "#/components/schemas/updateSettingsFlowWithTotpMethod", "webauthn": "#/components/schemas/updateSettingsFlowWithWebAuthnMethod" }, "propertyName": "method" }, "oneOf": [ { "$ref": "#/components/schemas/updateSettingsFlowWithPasswordMethod" }, { "$ref": "#/components/schemas/updateSettingsFlowWithProfileMethod" }, { "$ref": "#/components/schemas/updateSettingsFlowWithOidcMethod" }, { "$ref": "#/components/schemas/updateSettingsFlowWithSamlMethod" }, { "$ref": "#/components/schemas/updateSettingsFlowWithTotpMethod" }, { "$ref": "#/components/schemas/updateSettingsFlowWithWebAuthnMethod" }, { "$ref": "#/components/schemas/updateSettingsFlowWithLookupMethod" }, { "$ref": "#/components/schemas/updateSettingsFlowWithPasskeyMethod" }, { "$ref": "#/components/schemas/updateSettingsFlowWithDeviceAuthnMethod" } ] }, "updateSettingsFlowWithDeviceAuthnMethod": { "description": "Manages the identity's enrolled device keys. Set exactly one of\n`deviceauthn_register` (enroll a new key), `deviceauthn_remove` (remove a\nkey), or `rotate_secret` (re-issue the pin_secret of a PIN-protected key).", "properties": { "csrf_token": { "description": "CSRFToken is the anti-CSRF token.\nIt is only required to remove a key from the browser.", "type": "string" }, "deviceauthn_register": { "allOf": [ { "$ref": "#/components/schemas/updateSettingsFlowWithDeviceAuthnMethodRegister" } ], "description": "Enrolls a new device key. Set exactly one of deviceauthn_register, deviceauthn_remove, or rotate_secret." }, "deviceauthn_remove": { "description": "The client_key_id of the key to remove: the key's deterministic\nfingerprint, the lowercase-hex SHA-256 of the device public key in PKIX,\nASN.1 DER (SubjectPublicKeyInfo) form. Keys enrolled before the server\nderived the id use their original client-chosen value.", "type": "string" }, "method": { "description": "Method\n\nShould be set to \"deviceauthn\" when adding, removing, or rotating the\nsecret of a DeviceAuthn key.", "type": "string" }, "rotate_secret": { "allOf": [ { "$ref": "#/components/schemas/updateSettingsFlowWithDeviceAuthnMethodRotateSecret" } ], "description": "Re-issues the pin_secret of an existing PIN-protected device key. Set exactly one of deviceauthn_register, deviceauthn_remove, or rotate_secret." }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "method" ], "title": "Update Settings Flow with DeviceAuthn Method", "type": "object" }, "updateSettingsFlowWithDeviceAuthnMethodRegister": { "description": "Enrolls a new device key from a hardware-backed platform attestation.\nProvide exactly one of certificate_chain_android or attestation_ios. The\nattestation must embed the enrollment challenge, computed as follows:\n\n1. Base64-decode the settings flow's hidden `deviceauthn_nonce` UI node\nvalue, parse the result as JSON, and base64-decode its `nonce` field.\n2. For a key without a PIN, the raw nonce bytes are the challenge. For a\nPIN-protected key, the challenge is the SHA-256 of the raw nonce\nconcatenated with the raw transport_public_key bytes, which binds the\ntransport key into the attestation.\n\nFor a PIN-protected key the server returns a one-time sealed pin_secret in\nthe flow's `continue_with` items (action `show_pin_entry_ui`).", "properties": { "attestation_ios": { "description": "The CBOR-encoded Apple App Attest attestation object for the new key.\nGenerate the key with `DCAppAttestService.generateKey`, then obtain the\nattestation with `DCAppAttestService.attestKey`, passing the enrollment\nchallenge described above as the `clientDataHash` argument — do not hash\nit again — and submit the result unchanged. Set exactly one of\ncertificate_chain_android or attestation_ios.", "format": "byte", "type": "string" }, "certificate_chain_android": { "description": "The Android Key Attestation certificate chain for the new key, one\nbase64-encoded DER certificate per element, leaf first: the first element\ncertifies the on-device key, the last is the Google attestation root.\n\nGenerate the key on-device (imported keys are rejected) in the\nhardware-backed keystore as an elliptic-curve (P-224, P-256, P-384, or\nP-521) signing key:\n`KeyGenParameterSpec.Builder(alias, PURPOSE_SIGN)` with `DIGEST_SHA256`\nand `setAttestationChallenge(challenge)`, where challenge is the\nenrollment challenge described above. Then submit the chain returned by\n`KeyStore.getCertificateChain`. Set exactly one of\ncertificate_chain_android or attestation_ios.", "items": { "format": "byte", "type": "string" }, "type": "array" }, "device_name": { "description": "A human-readable name for the device, e.g. 'My work phone'. It helps the\nuser tell this key apart from others.", "type": "string" }, "pin_protected": { "description": "Set to true to enroll the key as PIN-protected. The server then mints a\n32-byte pin_secret and returns it exactly once, in the settings-flow\nresponse: the `continue_with` array contains an item with action\n`show_pin_entry_ui` whose `data.enc` (HPKE encapsulated key) and\n`data.ciphertext` (sealed pin_secret) fields are base64-encoded and\nsealed to transport_public_key. Open them on the device with the\ntransport private key using HPKE with DHKEM(X25519, HKDF-SHA256),\nHKDF-SHA256, AES-128-GCM, the ASCII info string\n\"ory/deviceauthn/pin-secret/v1\", and the client_key_id (its ASCII hex\nform) as the AAD, then bind the secret to the user's PIN locally. The\nsealed secret is never delivered again; logins with the key must then\ninclude a pin_proof.", "type": "boolean" }, "transport_public_key": { "description": "The device's X25519 transport public key (32 bytes, base64-encoded) used\nto seal the returned pin_secret so only this device can open it.\nRequired when pin_protected is true, ignored otherwise.\n\nGenerate a fresh, random X25519 key pair for each request — for example\nwith CryptoKit's `Curve25519.KeyAgreement.PrivateKey()` on iOS or\n`KeyPairGenerator.getInstance(\"XDH\")` on Android — and submit the raw\n32-byte public key. It is a transport-encryption key, distinct from the\nattested signing key. Keep the private key only until the sealed\npin_secret from the response has been opened, then discard it. The HPKE\nsuite is DHKEM(X25519, HKDF-SHA256), HKDF-SHA256, AES-128-GCM.", "format": "byte", "type": "string" }, "user_verification": { "allOf": [ { "$ref": "#/components/schemas/UserVerification" } ], "description": "Declares how the key's holder is verified at use time. One of \"pin\", \"platform\", or \"none\" (or empty, which maps to \"none\"). \"pin\" is implied by pin_protected and need not be set explicitly.\n\nFor \"platform\" on Android, generate the key with `setUserAuthenticationRequired(true)`: the server rejects the claim unless the attestation shows user-authentication gating (KeyMint user_auth_type). On iOS the declaration is trusted, since App Attest cannot prove biometric gating; iOS platform keys therefore count as a sole first factor only when the project enables ios_biometric_first_factor." }, "version": { "description": "The cryptography version to enroll the key with. Only `1` is currently\nsupported, which corresponds to ECDSA with SHA-256 on an elliptic curve\n(P-224, P-256, P-384, or P-521).", "format": "int64", "type": "integer" } }, "required": [ "device_name", "version" ], "title": "Update Settings Flow with DeviceAuthn Register", "type": "object" }, "updateSettingsFlowWithDeviceAuthnMethodRotateSecret": { "description": "Re-issues a fresh pin_secret for an existing PIN-protected DeviceAuthn key\nwithout changing the device signing key. It is the recovery path for a\nforgotten PIN or a locked key. The server returns the new secret exactly\nonce, HPKE-sealed to the supplied transport_public_key, in the flow's\n`continue_with` items (action `show_pin_entry_ui`).", "properties": { "client_key_id": { "description": "The client_key_id of the existing PIN-protected key whose pin_secret to\nrotate: the lowercase-hex SHA-256 of the device public key in PKIX,\nASN.1 DER (SubjectPublicKeyInfo) form. The device signing key is\nunchanged by the rotation.", "type": "string" }, "signature": { "description": "Proves current possession of the enrolled device signing key.\n\nTo compute it:\n\n1. Base64-decode the settings flow's hidden `deviceauthn_nonce` UI node\nvalue, parse the result as JSON, and base64-decode its `nonce` field.\n2. Concatenate the raw nonce bytes and the raw transport_public_key\nbytes; this is the challenge.\n3. Sign the challenge exactly as at login: on Android with\n`Signature.getInstance(\"SHA256withECDSA\")`, submitting the resulting\nASN.1 DER-encoded ECDSA signature; on iOS with\n`DCAppAttestService.generateAssertion`, passing the challenge bytes as\nthe `clientDataHash` argument — do not hash them again — and submitting\nthe returned CBOR-encoded App Attest assertion unchanged.\n\nBinding the transport key into the signed challenge ensures a hijacked\nsession (stolen token, XSS) cannot rotate the secret and have it sealed\nto a transport key it controls.", "format": "byte", "type": "string" }, "transport_public_key": { "description": "The device's X25519 transport public key (32 bytes, base64-encoded) used\nto seal the freshly issued pin_secret so only this device can open it.\n\nGenerate a fresh, random X25519 key pair for each rotation — it is a\ntransport-encryption key, distinct from the attested signing key — and\nsubmit the raw 32-byte public key. Keep the private key only until the\nsealed pin_secret from the response has been opened, then discard it.\nThe HPKE suite is DHKEM(X25519, HKDF-SHA256), HKDF-SHA256, AES-128-GCM.", "format": "byte", "type": "string" } }, "required": [ "client_key_id", "transport_public_key", "signature" ], "title": "Update Settings Flow with DeviceAuthn RotateSecret", "type": "object" }, "updateSettingsFlowWithLookupMethod": { "description": "Update Settings Flow with Lookup Method", "properties": { "csrf_token": { "description": "CSRFToken is the anti-CSRF token", "type": "string" }, "lookup_secret_confirm": { "description": "If set to true will save the regenerated lookup secrets", "type": "boolean" }, "lookup_secret_disable": { "description": "Disables this method if true.", "type": "boolean" }, "lookup_secret_regenerate": { "description": "If set to true will regenerate the lookup secrets", "type": "boolean" }, "lookup_secret_reveal": { "description": "If set to true will reveal the lookup secrets", "type": "boolean" }, "method": { "description": "Method\n\nShould be set to \"lookup\" when trying to add, update, or remove a lookup pairing.", "type": "string" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "method" ], "type": "object" }, "updateSettingsFlowWithOidcMethod": { "description": "Update Settings Flow with OpenID Connect Method", "properties": { "flow": { "description": "Flow ID is the flow's ID.\n\nin: query", "type": "string" }, "link": { "description": "Link this provider\n\nEither this or `unlink` must be set.\n\ntype: string\nin: body", "type": "string" }, "method": { "description": "Method\n\nShould be set to profile when trying to update a profile.", "type": "string" }, "traits": { "description": "The identity's traits\n\nin: body", "type": "object" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" }, "unlink": { "description": "Unlink this provider\n\nEither this or `link` must be set.\n\ntype: string\nin: body", "type": "string" }, "upstream_parameters": { "description": "UpstreamParameters are the parameters that are passed to the upstream identity provider.\n\nThese parameters are optional and depend on what the upstream identity provider supports.\nSupported parameters are:\n`hd` (string): The `hd` parameter limits the login/registration process to a Google Organization, e.g. `mycollege.edu`.\n`prompt` (string): The `prompt` specifies whether the Authorization Server prompts the End-User for reauthentication and consent, e.g. `select_account`.\n`acr_values` (string): The `acr_values` specifies the Authentication Context Class Reference values for the authorization request.", "type": "object" } }, "required": [ "method" ], "type": "object" }, "updateSettingsFlowWithPasskeyMethod": { "description": "Update Settings Flow with Passkey Method", "properties": { "csrf_token": { "description": "CSRFToken is the anti-CSRF token", "type": "string" }, "method": { "description": "Method\n\nShould be set to \"passkey\" when trying to add, update, or remove a webAuthn pairing.", "type": "string" }, "passkey_remove": { "description": "Remove a WebAuthn Security Key\n\nThis must contain the ID of the WebAuthN connection.", "type": "string" }, "passkey_settings_register": { "description": "Register a WebAuthn Security Key\n\nIt is expected that the JSON returned by the WebAuthn registration process\nis included here.", "type": "string" } }, "required": [ "method" ], "type": "object" }, "updateSettingsFlowWithPasswordMethod": { "description": "Update Settings Flow with Password Method", "properties": { "csrf_token": { "description": "CSRFToken is the anti-CSRF token", "type": "string" }, "method": { "description": "Method\n\nShould be set to password when trying to update a password.", "type": "string" }, "password": { "description": "Password is the updated password", "type": "string" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "password", "method" ], "type": "object" }, "updateSettingsFlowWithProfileMethod": { "description": "Update Settings Flow with Profile Method", "properties": { "csrf_token": { "description": "The Anti-CSRF Token\n\nThis token is only required when performing browser flows.", "type": "string" }, "method": { "description": "Method\n\nShould be set to profile when trying to update a profile.", "type": "string" }, "traits": { "description": "Traits\n\nThe identity's traits.", "type": "object" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "traits", "method" ], "type": "object" }, "updateSettingsFlowWithSamlMethod": { "description": "Update settings flow using SAML", "properties": { "csrf_token": { "description": "The CSRF Token", "type": "string" }, "flow": { "description": "Flow ID is the flow's ID.\n\nin: query", "type": "string" }, "link": { "description": "Link this provider\n\nEither this or `unlink` must be set.\n\ntype: string\nin: body", "type": "string" }, "method": { "description": "Method\n\nShould be set to saml when trying to update a profile.", "type": "string" }, "traits": { "description": "The identity's traits\n\nin: body", "type": "object" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" }, "unlink": { "description": "Unlink this provider\n\nEither this or `link` must be set.\n\ntype: string\nin: body", "type": "string" } }, "required": [ "method" ], "type": "object" }, "updateSettingsFlowWithTotpMethod": { "description": "Update Settings Flow with TOTP Method", "properties": { "csrf_token": { "description": "CSRFToken is the anti-CSRF token", "type": "string" }, "method": { "description": "Method\n\nShould be set to \"totp\" when trying to add, update, or remove a totp pairing.", "type": "string" }, "totp_code": { "description": "ValidationTOTP must contain a valid TOTP based on the", "type": "string" }, "totp_unlink": { "description": "UnlinkTOTP if true will remove the TOTP pairing,\neffectively removing the credential. This can be used\nto set up a new TOTP device.", "type": "boolean" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "method" ], "type": "object" }, "updateSettingsFlowWithWebAuthnMethod": { "description": "Update Settings Flow with WebAuthn Method", "properties": { "csrf_token": { "description": "CSRFToken is the anti-CSRF token", "type": "string" }, "method": { "description": "Method\n\nShould be set to \"webauthn\" when trying to add, update, or remove a webAuthn pairing.", "type": "string" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" }, "webauthn_register": { "description": "Register a WebAuthn Security Key\n\nIt is expected that the JSON returned by the WebAuthn registration process\nis included here.", "type": "string" }, "webauthn_register_displayname": { "description": "Name of the WebAuthn Security Key to be Added\n\nA human-readable name for the security key which will be added.", "type": "string" }, "webauthn_remove": { "description": "Remove a WebAuthn Security Key\n\nThis must contain the ID of the WebAuthN connection.", "type": "string" } }, "required": [ "method" ], "type": "object" }, "updateSubscriptionBody": { "properties": { "interval": { "description": "\nmonthly Monthly\nyearly Yearly", "enum": [ "monthly", "yearly" ], "type": "string", "x-go-enum-desc": "monthly Monthly\nyearly Yearly" }, "plan": { "type": "string" }, "return_to": { "type": "string" } }, "required": [ "plan", "interval" ], "type": "object" }, "updateVerificationFlowBody": { "description": "Update Verification Flow Request Body", "discriminator": { "mapping": { "code": "#/components/schemas/updateVerificationFlowWithCodeMethod", "link": "#/components/schemas/updateVerificationFlowWithLinkMethod" }, "propertyName": "method" }, "oneOf": [ { "$ref": "#/components/schemas/updateVerificationFlowWithLinkMethod" }, { "$ref": "#/components/schemas/updateVerificationFlowWithCodeMethod" } ] }, "updateVerificationFlowWithCodeMethod": { "properties": { "code": { "description": "Code from the recovery email\n\nIf you want to submit a code, use this field, but make sure to _not_ include the email field, as well.", "type": "string" }, "csrf_token": { "description": "Sending the anti-csrf token is only required for browser login flows.", "type": "string" }, "email": { "description": "The email address or phone number to verify\n\nIf the provided address belongs to a valid account, a verification email or SMS will be sent.\n\nIf you want to notify the email address if the account does not exist, see\nthe [notify_unknown_recipients flag](https://www.ory.com/docs/kratos/self-service/flows/verify-email-account-activation#attempted-verification-notifications)\n\nIf a code was already sent, including this field in the payload will invalidate the sent code and re-send a new code.", "type": "string" }, "method": { "description": "Method is the method that should be used for this verification flow\n\nAllowed values are `link` and `code`.\nlink VerificationStrategyLink\ncode VerificationStrategyCode", "enum": [ "link", "code" ], "type": "string", "x-go-enum-desc": "link VerificationStrategyLink\ncode VerificationStrategyCode" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "method" ], "type": "object" }, "updateVerificationFlowWithLinkMethod": { "description": "Update Verification Flow with Link Method", "properties": { "csrf_token": { "description": "Sending the anti-csrf token is only required for browser login flows.", "type": "string" }, "email": { "description": "Email to Verify\n\nNeeds to be set when initiating the flow. If the email is a registered\nverification email, a verification link will be sent. If the email is not known,\na email with details on what happened will be sent instead.\n\nformat: email", "type": "string" }, "method": { "description": "Method is the method that should be used for this verification flow\n\nAllowed values are `link` and `code`\nlink VerificationStrategyLink\ncode VerificationStrategyCode", "enum": [ "link", "code" ], "type": "string", "x-go-enum-desc": "link VerificationStrategyLink\ncode VerificationStrategyCode" }, "transient_payload": { "description": "Transient data to pass along to any webhooks", "type": "object" } }, "required": [ "email", "method" ], "type": "object" }, "updateWorkspaceBody": { "properties": { "access_policy": { "description": "The access policy of the workspace.\nIf the workspace is not linked to an organization, this field is ignored and\nthe access policy is set to \"INVITED_MEMBERS\", which allows all invited members\nto access the workspace.\nCHECK_ORGANIZATION_AND_WORKSPACE_MEMBERSHIP WorkspaceAccessPolicyOrganizationMembershipRequired Only invited members that are part of the organization defined for the workspace can access it\nCHECK_ACCESS_PERMISSION WorkspaceAccessPolicyMembershipRequired All invited members can access the workspace, regardless of their organization membership This is useful for migration scenarios where workspaces previously did not have an organization assigned If a user is just a member of a project within the workspace, they'll still have access to the project, but not to the workspace itself (the default for existing workspaces)", "enum": [ "CHECK_ORGANIZATION_AND_WORKSPACE_MEMBERSHIP", "CHECK_ACCESS_PERMISSION" ], "type": "string", "x-go-enum-desc": "CHECK_ORGANIZATION_AND_WORKSPACE_MEMBERSHIP WorkspaceAccessPolicyOrganizationMembershipRequired Only invited members that are part of the organization defined for the workspace can access it\nCHECK_ACCESS_PERMISSION WorkspaceAccessPolicyMembershipRequired All invited members can access the workspace, regardless of their organization membership This is useful for migration scenarios where workspaces previously did not have an organization assigned If a user is just a member of a project within the workspace, they'll still have access to the project, but not to the workspace itself (the default for existing workspaces)" }, "name": { "description": "The name of the workspace.", "type": "string" } }, "required": [ "name" ], "type": "object" }, "updateWorkspaceOrganizationBody": { "properties": { "session_lifespan": { "description": "SessionLifespan overrides the project-level session lifespan for sessions\nissued for this organization. A Go duration string between 1m and 8760h.\nAn empty string clears the override so the project default applies. When\nthe field is omitted, the stored value is left unchanged.", "example": "24h", "type": "string" } }, "type": "object" }, "validateBaseURLRewriteRequest": { "description": "The endpoint is mounted on backoffice's admin listener and is not exposed\non the public ingress; the bearer token is the credential. See\n.claude/docs/plans/courier-rewrite.md for the design.", "properties": { "base_url": { "description": "The base URL the proxy wants Kratos to rewrite courier links to,\ne.g. \"http://localhost:4000\" for the Ory CLI / NextJS proxy.", "type": "string" }, "project_id": { "description": "The Project ID the token is being authorized against.", "format": "uuid", "type": "string" }, "token": { "description": "The bearer token from the inbound Ory-Base-URL-Rewrite-Token header.", "type": "string" } }, "required": [ "project_id", "base_url", "token" ], "title": "ValidateBaseURLRewriteRequest is the JSON body of\nPOST /validate-base-url-rewrite, the internal endpoint Kratos cloud\ncalls at recovery / verification flow init time to authorize an\nOry-Base-URL-Rewrite header against the project's API tokens.", "type": "object" }, "validateBaseURLRewriteResponse": { "description": "ValidateBaseURLRewriteResponse is the response shape. The endpoint always\nreturns HTTP 200 with a structured outcome so the client has a single\nresponse shape for tracing and so neither side has to special-case 4xx\nvs. body parsing.", "properties": { "reason": { "description": "A machine-readable reason for negative outcomes. One of\n\"token_not_found\", \"missing_permission\", or \"invalid_base_url\".\nEmpty when valid is true.", "type": "string" }, "valid": { "description": "Whether the token authorizes the base URL rewrite.", "type": "boolean" } }, "required": [ "valid" ], "type": "object" }, "verifiableCredentialPrimingResponse": { "properties": { "c_nonce": { "type": "string" }, "c_nonce_expires_in": { "format": "int64", "type": "integer" }, "error": { "type": "string" }, "error_debug": { "type": "string" }, "error_description": { "type": "string" }, "error_hint": { "type": "string" }, "format": { "type": "string" }, "status_code": { "format": "int64", "type": "integer" } }, "title": "VerifiableCredentialPrimingResponse contains the nonce to include in the proof-of-possession JWT.", "type": "object" }, "verifiableCredentialResponse": { "properties": { "credential_draft_00": { "type": "string" }, "format": { "type": "string" } }, "title": "VerifiableCredentialResponse contains the verifiable credential.", "type": "object" }, "verifiableIdentityAddress": { "description": "VerifiableAddress is an identity's verifiable address", "properties": { "created_at": { "description": "When this entry was created", "example": "2014-01-01T23:28:56.782Z", "format": "date-time", "type": "string" }, "id": { "description": "The ID", "format": "uuid", "type": "string" }, "status": { "$ref": "#/components/schemas/identityVerifiableAddressStatus" }, "updated_at": { "description": "When this entry was last updated", "example": "2014-01-01T23:28:56.782Z", "format": "date-time", "type": "string" }, "value": { "description": "The address value\n\nexample foo@user.com", "type": "string" }, "verified": { "description": "Indicates if the address has already been verified", "example": true, "type": "boolean" }, "verified_at": { "$ref": "#/components/schemas/nullTime" }, "via": { "description": "The delivery method", "enum": [ "email", "sms" ], "example": "email", "type": "string" } }, "required": [ "value", "verified", "via", "status" ], "type": "object" }, "verificationFlow": { "description": "Used to verify an out-of-band communication\nchannel such as an email address or a phone number.\n\nFor more information head over to: https://www.ory.com/docs/kratos/self-service/flows/verify-email-account-activation", "properties": { "active": { "description": "Active, if set, contains the registration method that is being used. It is initially\nnot set.", "type": "string" }, "expires_at": { "description": "ExpiresAt is the time (UTC) when the request expires. If the user still wishes to verify the address,\na new request has to be initiated.", "format": "date-time", "type": "string" }, "id": { "description": "ID represents the request's unique ID. When performing the verification flow, this\nrepresents the id in the verify ui's query parameter: http://\u003cselfservice.flows.verification.ui_url\u003e?request=\u003cid\u003e\n\ntype: string\nformat: uuid", "format": "uuid", "type": "string" }, "issued_at": { "description": "IssuedAt is the time (UTC) when the request occurred.", "format": "date-time", "type": "string" }, "request_url": { "description": "RequestURL is the initial URL that was requested from Ory Kratos. It can be used\nto forward information contained in the URL's path or query for example.", "type": "string" }, "return_to": { "description": "ReturnTo contains the requested return_to URL.", "type": "string" }, "state": { "description": "State represents the state of this request:\n\nchoose_method: ask the user to choose a method (e.g. verify your email)\nsent_email: the email has been sent to the user\npassed_challenge: the request was successful and the verification challenge was passed." }, "transient_payload": { "description": "TransientPayload is used to pass data from the verification flow to hooks and email templates", "type": "object" }, "type": { "$ref": "#/components/schemas/selfServiceFlowType" }, "ui": { "$ref": "#/components/schemas/uiContainer" } }, "required": [ "id", "type", "ui", "state" ], "title": "A Verification Flow", "type": "object" }, "verificationFlowState": { "description": "The experimental state represents the state of a verification flow. This field is EXPERIMENTAL and subject to change!", "enum": [ "choose_method", "sent_email", "passed_challenge" ], "title": "Verification flow state (experimental)" }, "verifyUserCodeRequest": { "properties": { "client": { "$ref": "#/components/schemas/oAuth2Client" }, "device_code_request_id": { "type": "string" }, "request_url": { "description": "RequestURL is the original Device Authorization URL requested.", "type": "string" }, "requested_access_token_audience": { "description": "RequestedAudience contains the access token audience as requested by the OAuth 2.0 Client.", "items": { "type": "string" }, "type": "array" }, "requested_scope": { "description": "RequestedScope contains the OAuth 2.0 Scope requested by the OAuth 2.0 Client.", "items": { "type": "string" }, "type": "array" } }, "title": "HandledDeviceUserAuthRequest is the request payload used to accept a device user_code.", "type": "object" }, "version": { "properties": { "version": { "description": "Version is the service's version.", "type": "string" } }, "type": "object" }, "webAuthnJavaScript": { "type": "string" }, "workspace": { "properties": { "access_policy": { "description": "Controls who can access the workspace and its projects\n\nThis does not control access level, only who can access it at all.\nCHECK_ORGANIZATION_AND_WORKSPACE_MEMBERSHIP WorkspaceAccessPolicyOrganizationMembershipRequired Only invited members that are part of the organization defined for the workspace can access it\nCHECK_ACCESS_PERMISSION WorkspaceAccessPolicyMembershipRequired All invited members can access the workspace, regardless of their organization membership This is useful for migration scenarios where workspaces previously did not have an organization assigned If a user is just a member of a project within the workspace, they'll still have access to the project, but not to the workspace itself (the default for existing workspaces)", "enum": [ "CHECK_ORGANIZATION_AND_WORKSPACE_MEMBERSHIP", "CHECK_ACCESS_PERMISSION" ], "type": "string", "x-go-enum-desc": "CHECK_ORGANIZATION_AND_WORKSPACE_MEMBERSHIP WorkspaceAccessPolicyOrganizationMembershipRequired Only invited members that are part of the organization defined for the workspace can access it\nCHECK_ACCESS_PERMISSION WorkspaceAccessPolicyMembershipRequired All invited members can access the workspace, regardless of their organization membership This is useful for migration scenarios where workspaces previously did not have an organization assigned If a user is just a member of a project within the workspace, they'll still have access to the project, but not to the workspace itself (the default for existing workspaces)" }, "created_at": { "format": "date-time", "type": "string" }, "id": { "format": "uuid", "type": "string" }, "name": { "type": "string" }, "organization_id": { "$ref": "#/components/schemas/NullUUID" }, "subscription_id": { "$ref": "#/components/schemas/NullUUID" }, "subscription_plan": { "$ref": "#/components/schemas/String" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "id", "name", "created_at", "updated_at" ], "type": "object" }, "workspaceApiKey": { "properties": { "created_at": { "description": "The API key's creation date", "format": "date-time", "readOnly": true, "type": "string" }, "expires_at": { "$ref": "#/components/schemas/Time" }, "id": { "description": "The key's ID.", "format": "uuid", "readOnly": true, "type": "string" }, "last_characters": { "description": "The last characters of the key's value.\n\nLets you tell API keys apart in the UI without revealing the full\nvalue. Empty for keys created before this was introduced.", "readOnly": true, "type": "string" }, "name": { "description": "The API key's Name\n\nSet this to help you remember, for example, where you use the API key.", "type": "string" }, "owner_id": { "description": "The key's owner", "format": "uuid", "readOnly": true, "type": "string" }, "updated_at": { "description": "The API key's last update date", "format": "date-time", "readOnly": true, "type": "string" }, "value": { "description": "The key's value", "readOnly": true, "type": "string" }, "workspace_id": { "description": "The API key's workspace ID", "format": "uuid", "readOnly": true, "type": "string" } }, "required": [ "id", "name", "owner_id" ], "type": "object" }, "workspaceApiKeys": { "items": { "$ref": "#/components/schemas/workspaceApiKey" }, "type": "array" }, "workspaceOrganization": { "properties": { "active_link": { "$ref": "#/components/schemas/onboardingPortalLink" }, "created_at": { "format": "date-time", "type": "string" }, "default_region": { "description": "DefaultRegion sets the default region for identities provisioned into\nthis organization, when the identity does not specify a region explictly.\neu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global", "enum": [ "eu-central", "asia-northeast", "us-east", "us-west", "eu", "asia", "us", "global" ], "type": "string", "x-go-enum-desc": "eu-central EUCentral\nasia-northeast AsiaNorthEast\nus-east USEast\nus-west USWest\neu EU\nasia Asia\nus US\nglobal Global" }, "domains": { "description": "The list of organization's domains.", "items": { "type": "string" }, "type": "array" }, "id": { "description": "The organization's ID.", "format": "uuid", "type": "string" }, "label": { "description": "The organization's human-readable label.", "type": "string" }, "providers": { "items": { "type": "string" }, "type": "array" }, "session_lifespan": { "description": "SessionLifespan overrides the project-level session lifespan for sessions\nissued for this organization. A Go duration string between 1m and 8760h.\nA null (or zero) value means the project default applies.", "example": "24h", "pattern": "^[0-9]+(s|m|h)$", "type": "string" } }, "required": [ "id", "label", "domains", "created_at", "providers" ], "type": "object" }, "workspaces": { "items": { "$ref": "#/components/schemas/workspace" }, "type": "array" } }, "securitySchemes": { "basic": { "scheme": "basic", "type": "http" }, "bearer": { "scheme": "bearer", "type": "http" }, "oauth2": { "flows": { "authorizationCode": { "authorizationUrl": "https://hydra.demo.ory.sh/oauth2/auth", "scopes": { "offline": "A scope required when requesting refresh tokens (alias for `offline_access`)", "offline_access": "A scope required when requesting refresh tokens", "openid": "Request an OpenID Connect ID Token" }, "tokenUrl": "https://hydra.demo.ory.sh/oauth2/token" } }, "type": "oauth2" }, "oryAccessToken": { "description": "To use this endpoint you need an [Ory Network API key](https://www.ory.com/docs/concepts/personal-access-token).", "scheme": "bearer", "type": "http" }, "oryWorkspaceApiKey": { "description": "To use this endpoint you need a workspace-level [Ory Network API key](https://www.ory.com/docs/concepts/personal-access-token).", "scheme": "bearer", "type": "http" } } }, "info": { "contact": { "email": "support@ory.sh", "name": "API Support" }, "description": "# Introduction\nDocumentation for all public and administrative Ory APIs. Administrative APIs can only be accessed\nwith a valid Personal Access Token. Public APIs are mostly used in browsers.\n\n## SDKs\nThis document describes the APIs available in the Ory Network. The APIs are available as SDKs for the following languages:\n\n| Language | Download SDK | Documentation |\n| -------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------ |\n| Dart | [pub.dev](https://pub.dev/packages/ory_client) | [README](https://github.com/ory/sdk/blob/master/clients/client/dart/README.md) |\n| .NET | [nuget.org](https://www.nuget.org/packages/Ory.Client/) | [README](https://github.com/ory/sdk/blob/master/clients/client/dotnet/README.md) |\n| Elixir | [hex.pm](https://hex.pm/packages/ory_client) | [README](https://github.com/ory/sdk/blob/master/clients/client/elixir/README.md) |\n| Go | [github.com](https://github.com/ory/client-go) | [README](https://github.com/ory/sdk/blob/master/clients/client/go/README.md) |\n| Java | [maven.org](https://search.maven.org/artifact/sh.ory/ory-client) | [README](https://github.com/ory/sdk/blob/master/clients/client/java/README.md) |\n| JavaScript | [npmjs.com](https://www.npmjs.com/package/@ory/client) | [README](https://github.com/ory/sdk/blob/master/clients/client/typescript/README.md) |\n| JavaScript (With fetch) | [npmjs.com](https://www.npmjs.com/package/@ory/client-fetch) | [README](https://github.com/ory/sdk/blob/master/clients/client/typescript-fetch/README.md) | \n| PHP | [packagist.org](https://packagist.org/packages/ory/client) | [README](https://github.com/ory/sdk/blob/master/clients/client/php/README.md) |\n| Python | [pypi.org](https://pypi.org/project/ory-client/) | [README](https://github.com/ory/sdk/blob/master/clients/client/python/README.md) |\n| Ruby | [rubygems.org](https://rubygems.org/gems/ory-client) | [README](https://github.com/ory/sdk/blob/master/clients/client/ruby/README.md) |\n| Rust | [crates.io](https://crates.io/crates/ory-client) | [README](https://github.com/ory/sdk/blob/master/clients/client/rust/README.md) |\n", "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "termsOfService": "/tos", "title": "Ory APIs", "version": "latest" }, "openapi": "3.0.3", "paths": { "/.well-known/change-password": { "get": { "description": "This endpoint implements the W3C \"change password URL\" well-known location by\nredirecting the browser to the configured settings UI. Password managers follow\nthis redirect to take users straight to the page where they can change their\npassword.", "operationId": "getWellKnownChangePassword", "responses": { "303": { "$ref": "#/components/responses/emptyResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Change Password URL", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-high" } }, "/.well-known/jwks.json": { "get": { "description": "This endpoint returns JSON Web Keys required to verifying OpenID Connect ID Tokens and,\nif enabled, OAuth 2.0 JWT Access Tokens. This endpoint can be used with client libraries like\n[node-jwks-rsa](https://github.com/auth0/node-jwks-rsa) among others.\n\nAdding custom keys requires first creating a keyset via the createJsonWebKeySet operation,\nand then configuring the webfinger.jwks.broadcast_keys configuration value to include the keyset name.", "operationId": "discoverJsonWebKeys", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/jsonWebKeySet" } } }, "description": "jsonWebKeySet" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "summary": "Discover Well-Known JSON Web Keys", "tags": [ "wellknown" ], "x-ory-ratelimit-bucket": "hydra-public-high" } }, "/.well-known/openid-configuration": { "get": { "description": "A mechanism for an OpenID Connect Relying Party to discover the End-User's OpenID Provider and obtain information needed to interact with it, including its OAuth 2.0 endpoint locations.\n\nPopular libraries for OpenID Connect clients include oidc-client-js (JavaScript), go-oidc (Golang), and others.\nFor a full list of clients go here: https://openid.net/developers/certified/", "operationId": "discoverOidcConfiguration", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oidcConfiguration" } } }, "description": "oidcConfiguration" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "summary": "OpenID Connect Discovery", "tags": [ "oidc" ], "x-ory-ratelimit-bucket": "hydra-public-high" } }, "/.well-known/ory/webauthn.js": { "get": { "description": "This endpoint provides JavaScript which is needed in order to perform WebAuthn login and registration.\n\nIf you are building a JavaScript Browser App (e.g. in ReactJS or AngularJS) you will need to load this file:\n\n```html\n\u003cscript src=\"https://public-kratos.example.org/.well-known/ory/webauthn.js\" type=\"script\" async /\u003e\n```\n\nMore information can be found at [Ory Kratos User Login](https://www.ory.com/docs/kratos/self-service/flows/user-login) and [User Registration Documentation](https://www.ory.com/docs/kratos/self-service/flows/user-registration).", "operationId": "getWebAuthnJavaScript", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/webAuthnJavaScript" } } }, "description": "webAuthnJavaScript" } }, "summary": "Get WebAuthn JavaScript", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "hydra-public-high" } }, "/admin/clients": { "get": { "description": "This endpoint lists all clients in the database, and never returns client secrets.\nAs a default it lists the first 100 clients.", "operationId": "listOAuth2Clients", "parameters": [ { "description": "Items per Page\n\nThis is the number of items per page to return.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_size", "schema": { "default": 250, "format": "int64", "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "Next Page Token\n\nThe next page token.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_token", "schema": { "type": "string" } }, { "description": "The name of the clients to filter by.", "in": "query", "name": "client_name", "schema": { "type": "string" } }, { "description": "The owner of the clients to filter by.", "in": "query", "name": "owner", "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/listOAuth2Clients" }, "default": { "$ref": "#/components/responses/errorOAuth2Default" } }, "security": [ { "oryAccessToken": [] } ], "summary": "List OAuth 2.0 Clients", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-medium" }, "post": { "description": "Create a new OAuth 2.0 client. If you pass `client_secret` the secret is used, otherwise a random secret\nis generated. The secret is echoed in the response. It is not possible to retrieve it later on.", "operationId": "createOAuth2Client", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2Client" } } }, "description": "OAuth 2.0 Client Request Body", "required": true, "x-originalParamName": "Body" }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2Client" } } }, "description": "oAuth2Client" }, "400": { "$ref": "#/components/responses/errorOAuth2BadRequest" }, "default": { "$ref": "#/components/responses/errorOAuth2Default" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Create OAuth 2.0 Client", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-low" } }, "/admin/clients/{id}": { "delete": { "description": "Delete an existing OAuth 2.0 Client by its ID.\n\nOAuth 2.0 clients are used to perform OAuth 2.0 and OpenID Connect flows. Usually, OAuth 2.0 clients are\ngenerated for applications which want to consume your OAuth 2.0 or OpenID Connect capabilities.\n\nMake sure that this endpoint is well protected and only callable by first-party components.", "operationId": "deleteOAuth2Client", "parameters": [ { "description": "The id of the OAuth 2.0 Client.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Delete OAuth 2.0 Client", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-low" }, "get": { "description": "Get an OAuth 2.0 client by its ID. This endpoint never returns the client secret.\n\nOAuth 2.0 clients are used to perform OAuth 2.0 and OpenID Connect flows. Usually, OAuth 2.0 clients are\ngenerated for applications which want to consume your OAuth 2.0 or OpenID Connect capabilities.", "operationId": "getOAuth2Client", "parameters": [ { "description": "The id of the OAuth 2.0 Client.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2Client" } } }, "description": "oAuth2Client" }, "default": { "$ref": "#/components/responses/errorOAuth2Default" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Get an OAuth 2.0 Client", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-high" }, "patch": { "description": "Patch an existing OAuth 2.0 Client using JSON Patch. If you update\n`client_secret`, the secret will be updated and returned via the API. This is\nthe only time you will be able to retrieve the client secret. Passing a new\n`client_secret` will clear all rotated secrets.\n\nTo perform a seamless client secret rotation, use the `rotateOAuth2ClientSecret` endpoint instead.\n\nOAuth 2.0 clients are used to perform OAuth 2.0 and OpenID Connect flows. Usually, OAuth 2.0 clients are\ngenerated for applications which want to consume your OAuth 2.0 or OpenID Connect capabilities.", "operationId": "patchOAuth2Client", "parameters": [ { "description": "The id of the OAuth 2.0 Client.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/jsonPatchDocument" } } }, "description": "OAuth 2.0 Client JSON Patch Body", "required": true, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2Client" } } }, "description": "oAuth2Client" }, "404": { "$ref": "#/components/responses/errorOAuth2NotFound" }, "default": { "$ref": "#/components/responses/errorOAuth2Default" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Patch OAuth 2.0 Client", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-low" }, "put": { "description": "Replaces an existing OAuth 2.0 Client with the payload you send. If you pass `client_secret` the secret is used,\notherwise the existing secret is used. Rotated secrets will be cleared if you pass a new `client_secret`.\n\nIf set, the secret is echoed in the response. It is not possible to retrieve it later on.\n\nTo perform a seamless client secret rotation, use the `rotateOAuth2ClientSecret` endpoint instead.\n\nOAuth 2.0 Clients are used to perform OAuth 2.0 and OpenID Connect flows. Usually, OAuth 2.0 clients are\ngenerated for applications which want to consume your OAuth 2.0 or OpenID Connect capabilities.", "operationId": "setOAuth2Client", "parameters": [ { "description": "OAuth 2.0 Client ID", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2Client" } } }, "description": "OAuth 2.0 Client Request Body", "required": true, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2Client" } } }, "description": "oAuth2Client" }, "400": { "$ref": "#/components/responses/errorOAuth2BadRequest" }, "404": { "$ref": "#/components/responses/errorOAuth2NotFound" }, "default": { "$ref": "#/components/responses/errorOAuth2Default" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Set OAuth 2.0 Client", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-low" } }, "/admin/clients/{id}/lifespans": { "put": { "description": "Set lifespans of different token types issued for this OAuth 2.0 client. Does not modify other fields.", "operationId": "setOAuth2ClientLifespans", "parameters": [ { "description": "OAuth 2.0 Client ID", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2ClientTokenLifespans" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2Client" } } }, "description": "oAuth2Client" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Set OAuth2 Client Token Lifespans", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-low" } }, "/admin/clients/{id}/secrets/rotate": { "delete": { "description": "Removes all rotated secrets from an OAuth 2.0 client. This should be called after all services\nhave been updated to use the new secret and the old secrets are no longer needed.", "operationId": "deleteRotatedOAuth2ClientSecrets", "parameters": [ { "description": "OAuth 2.0 Client ID", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2Client" } } }, "description": "oAuth2Client" }, "404": { "$ref": "#/components/responses/errorOAuth2NotFound" }, "default": { "$ref": "#/components/responses/errorOAuth2Default" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Delete Rotated OAuth 2.0 Client Secrets", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-high" }, "post": { "description": "Rotates an OAuth 2.0 client's secrets. The old secret will remain valid for\nauthentication, allowing for zero-downtime secret rotations. A new secret\nwill be generated and returned in the response.\n\nUp to five rotated secrets are retained. Use the\n`deleteRotatedOAuth2ClientSecrets` endpoint to remove old rotated secrets\nwhen they are no longer needed.", "operationId": "rotateOAuth2ClientSecret", "parameters": [ { "description": "OAuth 2.0 Client ID", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2Client" } } }, "description": "oAuth2Client" }, "404": { "$ref": "#/components/responses/errorOAuth2NotFound" }, "default": { "$ref": "#/components/responses/errorOAuth2Default" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Rotate OAuth 2.0 Client Secret", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-high" } }, "/admin/courier/messages": { "get": { "description": "Lists all messages by given status and recipient.", "operationId": "listCourierMessages", "parameters": [ { "description": "Items per Page\n\nThis is the number of items per page to return.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_size", "schema": { "default": 250, "format": "int64", "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "Next Page Token\n\nThe next page token.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_token", "schema": { "type": "string" } }, { "description": "Status filters out messages based on status.\nIf no value is provided, it doesn't take effect on filter.", "in": "query", "name": "status", "schema": { "$ref": "#/components/schemas/courierMessageStatus" } }, { "description": "Recipient filters out messages based on recipient.\nIf no value is provided, it doesn't take effect on filter.", "in": "query", "name": "recipient", "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/listCourierMessages" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "List Messages", "tags": [ "courier" ], "x-ory-ratelimit-bucket": "kratos-admin-low" } }, "/admin/courier/messages/{id}": { "get": { "description": "Gets a specific messages by the given ID.", "operationId": "getCourierMessage", "parameters": [ { "description": "MessageID is the ID of the message.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/message" } } }, "description": "message" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Get a Message", "tags": [ "courier" ], "x-ory-ratelimit-bucket": "kratos-admin-medium" } }, "/admin/identities": { "get": { "description": "Lists all [identities](https://www.ory.com/docs/kratos/concepts/identity-user-model) in the system. Note: filters cannot be combined.", "operationId": "listIdentities", "parameters": [ { "description": "Deprecated Items per Page\n\nDEPRECATED: Please use `page_token` instead. This parameter will be removed in the future.\n\nThis is the number of items per page.", "in": "query", "name": "per_page", "schema": { "default": 250, "format": "int64", "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "Deprecated Pagination Page\n\nDEPRECATED: Please use `page_token` instead. This parameter will be removed in the future.\n\nThis value is currently an integer, but it is not sequential. The value is not the page number, but a\nreference. The next page can be any number and some numbers might return an empty list.\n\nFor example, page 2 might not follow after page 1. And even if page 3 and 5 exist, but page 4 might not exist.\nThe first page can be retrieved by omitting this parameter. Following page pointers will be returned in the\n`Link` header.", "in": "query", "name": "page", "schema": { "format": "int64", "type": "integer" } }, { "description": "Page Size\n\nThis is the number of items per page to return. For details on pagination please head over to the\n[pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_size", "schema": { "default": 250, "format": "int64", "maximum": 500, "minimum": 1, "type": "integer" } }, { "description": "Next Page Token\n\nThe next page token. For details on pagination please head over to the\n[pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_token", "schema": { "type": "string" } }, { "description": "Read Consistency Level (preview)\n\nThe read consistency level determines the consistency guarantee for reads:\n\nstrong (slow): The read is guaranteed to return the most recent data committed at the start of the read.\neventual (very fast): The result will return data that is about 4.8 seconds old.\n\nThe default consistency guarantee can be changed in the Ory Network Console or using the Ory CLI with\n`ory patch project --replace '/previews/default_read_consistency_level=\"strong\"'`.\n\nSetting the default consistency level to `eventual` may cause regressions in the future as we add consistency\ncontrols to more APIs. Currently, the following APIs will be affected by this setting:\n\n`GET /admin/identities`\n\nThis feature is in preview and only available in Ory Network.\n ConsistencyLevelUnset ConsistencyLevelUnset is the unset / default consistency level.\nstrong ConsistencyLevelStrong ConsistencyLevelStrong is the strong consistency level.\neventual ConsistencyLevelEventual ConsistencyLevelEventual is the eventual consistency level using follower read timestamps.", "in": "query", "name": "consistency", "schema": { "enum": [ "", "strong", "eventual" ], "type": "string" }, "x-go-enum-desc": " ConsistencyLevelUnset ConsistencyLevelUnset is the unset / default consistency level.\nstrong ConsistencyLevelStrong ConsistencyLevelStrong is the strong consistency level.\neventual ConsistencyLevelEventual ConsistencyLevelEventual is the eventual consistency level using follower read timestamps." }, { "description": "Retrieve multiple identities by their IDs.\n\nThis parameter has the following limitations:\n\nDuplicate or non-existent IDs are ignored.\nThe order of returned IDs may be different from the request.\nThis filter does not support pagination. You must implement your own pagination as the maximum number of items returned by this endpoint may not exceed a certain threshold (currently 500).", "in": "query", "name": "ids", "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "CredentialsIdentifier is the identifier (username, email) of the credentials to look up using exact match.\nOnly one of CredentialsIdentifier and CredentialsIdentifierSimilar can be used.", "in": "query", "name": "credentials_identifier", "schema": { "type": "string" } }, { "description": "This is an EXPERIMENTAL parameter that WILL CHANGE. Do NOT rely on consistent, deterministic behavior.\nTHIS PARAMETER WILL BE REMOVED IN AN UPCOMING RELEASE WITHOUT ANY MIGRATION PATH.\n\nCredentialsIdentifierSimilar is the (partial) identifier (username, email) of the credentials to look up using similarity search.\nOnly one of CredentialsIdentifier and CredentialsIdentifierSimilar can be used.", "in": "query", "name": "preview_credentials_identifier_similar", "schema": { "type": "string" } }, { "description": "Include Credentials in Response\n\nInclude any credential, for example `password` or `oidc`, in the response. When set to `oidc`, This will return\nthe initial OAuth 2.0 Access Token, OAuth 2.0 Refresh Token, and the OpenID Connect ID Token if available.", "in": "query", "name": "include_credential", "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "List identities that belong to a specific organization.", "in": "query", "name": "organization_id", "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/listIdentities" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "List Identities", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-medium" }, "patch": { "description": "Creates multiple [identities](https://www.ory.com/docs/kratos/concepts/identity-user-model).\n\nYou can also use this endpoint to [import credentials](https://www.ory.com/docs/kratos/manage-identities/import-user-accounts-identities),\nincluding passwords, social sign-in settings, and multi-factor authentication methods.\n\nIf the patch includes hashed passwords you can import up to 1,000 identities per request.\n\nIf the patch includes at least one plaintext password you can import up to 200 identities per request.\n\nAvoid importing large batches with plaintext passwords. They can cause timeouts as the passwords need to be hashed before they are stored.\n\nIf at least one identity is imported successfully, the response status is 200 OK.\nIf all imports fail, the response is one of the following 4xx errors:\n400 Bad Request: The request payload is invalid or improperly formatted.\n409 Conflict: Duplicate identities or conflicting data were detected.\n\nIf you get a 504 Gateway Timeout:\nReduce the batch size\nAvoid duplicate identities\nPre-hash passwords with BCrypt\n\nIf the issue persists, contact support.", "operationId": "batchPatchIdentities", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/patchIdentitiesBody" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/batchPatchIdentitiesResponse" } } }, "description": "batchPatchIdentitiesResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Create multiple identities", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-low" }, "post": { "description": "Create an [identity](https://www.ory.com/docs/kratos/concepts/identity-user-model). This endpoint can also be used to\n[import credentials](https://www.ory.com/docs/kratos/manage-identities/import-user-accounts-identities)\nfor instance passwords, social sign in configurations, or multifactor methods.", "operationId": "createIdentity", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/createIdentityBody" } } }, "x-originalParamName": "Body" }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/identity" } } }, "description": "identity" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Create an Identity", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-low" } }, "/admin/identities/by/external/{externalID}": { "get": { "description": "Return an [identity](https://www.ory.com/docs/kratos/concepts/identity-user-model) by its external ID. You can optionally\ninclude credentials (e.g. social sign in connections) in the response by using the `include_credential` query parameter.", "operationId": "getIdentityByExternalID", "parameters": [ { "description": "ExternalID must be set to the ID of identity you want to get", "in": "path", "name": "externalID", "required": true, "schema": { "type": "string" } }, { "description": "Include Credentials in Response\n\nInclude any credential, for example `password` or `oidc`, in the response. When set to `oidc`, This will return\nthe initial OAuth 2.0 Access Token, OAuth 2.0 Refresh Token, and the OpenID Connect ID Token if available.", "in": "query", "name": "include_credential", "schema": { "items": { "enum": [ "password", "oidc", "totp", "lookup_secret", "webauthn", "code", "passkey", "profile", "saml", "deviceauthn", "identifier_first", "link_recovery", "code_recovery" ], "type": "string" }, "type": "array" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/identity" } } }, "description": "identity" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Get an Identity by its External ID", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-medium" } }, "/admin/identities/{id}": { "delete": { "description": "Calling this endpoint irrecoverably and permanently deletes the [identity](https://www.ory.com/docs/kratos/concepts/identity-user-model) given its ID. This action can not be undone.\nThis endpoint returns 204 when the identity was deleted or 404 if the identity was not found.", "operationId": "deleteIdentity", "parameters": [ { "description": "ID is the identity's ID.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Delete an Identity", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-low" }, "get": { "description": "Return an [identity](https://www.ory.com/docs/kratos/concepts/identity-user-model) by its ID. You can optionally\ninclude credentials (e.g. social sign in connections) in the response by using the `include_credential` query parameter.", "operationId": "getIdentity", "parameters": [ { "description": "ID must be set to the ID of identity you want to get", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "description": "Include Credentials in Response\n\nInclude any credential, for example `password` or `oidc`, in the response. When set to `oidc`, This will return\nthe initial OAuth 2.0 Access Token, OAuth 2.0 Refresh Token, and the OpenID Connect ID Token if available.", "in": "query", "name": "include_credential", "schema": { "items": { "enum": [ "password", "oidc", "totp", "lookup_secret", "webauthn", "code", "passkey", "profile", "saml", "deviceauthn", "identifier_first", "link_recovery", "code_recovery" ], "type": "string" }, "type": "array" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/identity" } } }, "description": "identity" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Get an Identity", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-high" }, "patch": { "description": "Partially updates an [identity's](https://www.ory.com/docs/kratos/concepts/identity-user-model) field using [JSON Patch](https://jsonpatch.com/).\nThe fields `id`, `stateChangedAt` and `credentials` can not be updated using this method.", "operationId": "patchIdentity", "parameters": [ { "description": "ID must be set to the ID of identity you want to update", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/jsonPatchDocument" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/identity" } } }, "description": "identity" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Patch an Identity", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-low" }, "put": { "description": "This endpoint updates an [identity](https://www.ory.com/docs/kratos/concepts/identity-user-model). The full identity\npayload (except credentials) is expected.\n\nIt is possible to update the identity's credentials as well. Using this operation, credentials will not be overwritten\nbut instead added to the list. For example, if a user has a social sign in connection set up, updating the credentials\nwill keep the social sign in connection and add the new credentials to the list. This prevents accidentally overwriting\ncredentials and locking out users. A complete view of all credential types is here:\n\n`password`: The existing password credential will be completely replaced with the new configuration. You can provide either a hashed password, a plaintext password (which will be hashed), or enable the password migration hook.\n`oidc`, `saml`: The existing OIDC and SAML credentials will be kept and the new credentials will be added to the list.\n`totp`: The existing TOTP credentials will be replaced with the new configuration.\n`lookup_secret`: The existing Lookup Secret codes will be kept and the new codes will be added to the list.\n`webauthn`, `passkey`: The existing credentials are preserved, new credentials are added, and credentials with matching IDs are updated with new values. If a new `user_handle` is provided, it's added to the identity's identifiers list while preserving previous user handles.\n`code`: To import code credentials, configure your identity schema to use one of the identity traits as an identifier source (`{\"ory.sh/kratos\":{\"code\":{\"identifier\":true\", \"via\":\"email\"}}}`).", "operationId": "updateIdentity", "parameters": [ { "description": "ID must be set to the ID of identity you want to update", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/updateIdentityBody" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/identity" } } }, "description": "identity" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Update an Identity", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-low" } }, "/admin/identities/{id}/credentials/{type}": { "delete": { "description": "Delete an [identity](https://www.ory.com/docs/kratos/concepts/identity-user-model) credential by its type.\nYou cannot delete passkeys or code auth credentials through this API.", "operationId": "deleteIdentityCredentials", "parameters": [ { "description": "ID is the identity's ID.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "description": "Type is the type of credentials to delete.\npassword CredentialsTypePassword\noidc CredentialsTypeOIDC\ntotp CredentialsTypeTOTP\nlookup_secret CredentialsTypeLookup\nwebauthn CredentialsTypeWebAuthn\ncode CredentialsTypeCodeAuth\npasskey CredentialsTypePasskey\nprofile CredentialsTypeProfile\nsaml CredentialsTypeSAML\ndeviceauthn CredentialsTypeDeviceAuthn\nidentifier_first CredentialsTypeIdentifierFirst\nlink_recovery CredentialsTypeRecoveryLink CredentialsTypeRecoveryLink is a special credential type linked to the link strategy (recovery flow). It is not used within the credentials object itself.\ncode_recovery CredentialsTypeRecoveryCode", "in": "path", "name": "type", "required": true, "schema": { "enum": [ "password", "oidc", "totp", "lookup_secret", "webauthn", "code", "passkey", "profile", "saml", "deviceauthn", "identifier_first", "link_recovery", "code_recovery" ], "type": "string" }, "x-go-enum-desc": "password CredentialsTypePassword\noidc CredentialsTypeOIDC\ntotp CredentialsTypeTOTP\nlookup_secret CredentialsTypeLookup\nwebauthn CredentialsTypeWebAuthn\ncode CredentialsTypeCodeAuth\npasskey CredentialsTypePasskey\nprofile CredentialsTypeProfile\nsaml CredentialsTypeSAML\ndeviceauthn CredentialsTypeDeviceAuthn\nidentifier_first CredentialsTypeIdentifierFirst\nlink_recovery CredentialsTypeRecoveryLink CredentialsTypeRecoveryLink is a special credential type linked to the link strategy (recovery flow). It is not used within the credentials object itself.\ncode_recovery CredentialsTypeRecoveryCode" }, { "description": "Identifier is the identifier of the credential to delete. It is required\nfor the `oidc`, `saml`, and `deviceauthn` credential types: for `oidc`\nand `saml` it selects the provider link to remove, for `deviceauthn` it\nis the `client_key_id` of the device key to revoke. Find the identifier\nby calling the `GET /admin/identities/{id}?include_credential={type}`\nendpoint.", "in": "query", "name": "identifier", "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Delete a credential for a specific identity", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-low" } }, "/admin/identities/{id}/sessions": { "delete": { "description": "Calling this endpoint irrecoverably and permanently deletes and invalidates all sessions that belong to the given Identity.", "operationId": "deleteIdentitySessions", "parameters": [ { "description": "ID is the identity's ID.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Delete \u0026 Invalidate an Identity's Sessions", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-low" }, "get": { "description": "This endpoint returns all sessions that belong to the given Identity.", "operationId": "listIdentitySessions", "parameters": [ { "description": "Deprecated Items per Page\n\nDEPRECATED: Please use `page_token` instead. This parameter will be removed in the future.\n\nThis is the number of items per page.", "in": "query", "name": "per_page", "schema": { "default": 250, "format": "int64", "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "Deprecated Pagination Page\n\nDEPRECATED: Please use `page_token` instead. This parameter will be removed in the future.\n\nThis value is currently an integer, but it is not sequential. The value is not the page number, but a\nreference. The next page can be any number and some numbers might return an empty list.\n\nFor example, page 2 might not follow after page 1. And even if page 3 and 5 exist, but page 4 might not exist.\nThe first page can be retrieved by omitting this parameter. Following page pointers will be returned in the\n`Link` header.", "in": "query", "name": "page", "schema": { "format": "int64", "type": "integer" } }, { "description": "Page Size\n\nThis is the number of items per page to return. For details on pagination please head over to the\n[pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_size", "schema": { "default": 250, "format": "int64", "maximum": 500, "minimum": 1, "type": "integer" } }, { "description": "Next Page Token\n\nThe next page token. For details on pagination please head over to the\n[pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_token", "schema": { "type": "string" } }, { "description": "ID is the identity's ID.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "description": "Active is a boolean flag that filters out sessions based on the state. If no value is provided, all sessions are returned.", "in": "query", "name": "active", "schema": { "type": "boolean" } } ], "responses": { "200": { "$ref": "#/components/responses/listIdentitySessions" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "List an Identity's Sessions", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-medium" } }, "/admin/keys/{set}": { "delete": { "description": "Use this endpoint to delete a complete JSON Web Key Set and all the keys in that set.\n\nA JSON Web Key (JWK) is a JavaScript Object Notation (JSON) data structure that represents a cryptographic key. A JWK Set is a JSON data structure that represents a set of JWKs. A JSON Web Key is identified by its set and key id. ORY Hydra uses this functionality to store cryptographic keys used for TLS and JSON Web Tokens (such as OpenID Connect ID tokens), and allows storing user-defined keys as well.", "operationId": "deleteJsonWebKeySet", "parameters": [ { "description": "The JSON Web Key Set", "in": "path", "name": "set", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Delete JSON Web Key Set", "tags": [ "jwk" ], "x-ory-ratelimit-bucket": "hydra-admin-low" }, "get": { "description": "This endpoint can be used to retrieve JWK Sets stored in ORY Hydra.\n\nA JSON Web Key (JWK) is a JavaScript Object Notation (JSON) data structure that represents a cryptographic key. A JWK Set is a JSON data structure that represents a set of JWKs. A JSON Web Key is identified by its set and key id. ORY Hydra uses this functionality to store cryptographic keys used for TLS and JSON Web Tokens (such as OpenID Connect ID tokens), and allows storing user-defined keys as well.", "operationId": "getJsonWebKeySet", "parameters": [ { "description": "JSON Web Key Set ID", "in": "path", "name": "set", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/jsonWebKeySet" } } }, "description": "jsonWebKeySet" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Retrieve a JSON Web Key Set", "tags": [ "jwk" ], "x-ory-ratelimit-bucket": "hydra-admin-medium" }, "post": { "description": "This endpoint is capable of generating JSON Web Key Sets for you. There are different strategies available, such as symmetric cryptographic keys (HS256, HS512) and asymmetric cryptographic keys (RS256, ECDSA). If the specified JSON Web Key Set does not exist, it will be created.\n\nIf the set already exists, the newly generated key is added to it and all existing keys are kept. This allows you to rotate keys: tokens signed with an older key in the set remain verifiable. Exception: when Ory Hydra is configured to use a Hardware Security Module (HSM), generating a key replaces the set, which then contains only the new key. To replace a set and all of its keys instead, use the `setJsonWebKeySet` operation (`PUT /admin/keys/{set}`).\n\nA JSON Web Key (JWK) is a JavaScript Object Notation (JSON) data structure that represents a cryptographic key. A JWK Set is a JSON data structure that represents a set of JWKs. A JSON Web Key is identified by its set and key id. ORY Hydra uses this functionality to store cryptographic keys used for TLS and JSON Web Tokens (such as OpenID Connect ID tokens), and allows storing user-defined keys as well.", "operationId": "createJsonWebKeySet", "parameters": [ { "description": "The JSON Web Key Set ID", "in": "path", "name": "set", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/createJsonWebKeySet" } } }, "required": true, "x-originalParamName": "Body" }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/jsonWebKeySet" } } }, "description": "jsonWebKeySet" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Create JSON Web Key", "tags": [ "jwk" ], "x-ory-ratelimit-bucket": "hydra-admin-low" }, "put": { "description": "Use this method if you do not want to let Hydra generate the JWKs for you, but instead save your own.\n\nThis operation replaces the entire JSON Web Key Set: keys that exist in the set but are not part of the request body are deleted. To add a newly generated key to the set while keeping the existing keys, use the `createJsonWebKeySet` operation (`POST /admin/keys/{set}`).\n\nA JSON Web Key (JWK) is a JavaScript Object Notation (JSON) data structure that represents a cryptographic key. A JWK Set is a JSON data structure that represents a set of JWKs. A JSON Web Key is identified by its set and key id. ORY Hydra uses this functionality to store cryptographic keys used for TLS and JSON Web Tokens (such as OpenID Connect ID tokens), and allows storing user-defined keys as well.", "operationId": "setJsonWebKeySet", "parameters": [ { "description": "The JSON Web Key Set ID", "in": "path", "name": "set", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/jsonWebKeySet" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/jsonWebKeySet" } } }, "description": "jsonWebKeySet" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Update a JSON Web Key Set", "tags": [ "jwk" ], "x-ory-ratelimit-bucket": "hydra-admin-low" } }, "/admin/keys/{set}/{kid}": { "delete": { "description": "Use this endpoint to delete a single JSON Web Key.\n\nA JSON Web Key (JWK) is a JavaScript Object Notation (JSON) data structure that represents a cryptographic key. A\nJWK Set is a JSON data structure that represents a set of JWKs. A JSON Web Key is identified by its set and key id. ORY Hydra uses\nthis functionality to store cryptographic keys used for TLS and JSON Web Tokens (such as OpenID Connect ID tokens),\nand allows storing user-defined keys as well.", "operationId": "deleteJsonWebKey", "parameters": [ { "description": "The JSON Web Key Set", "in": "path", "name": "set", "required": true, "schema": { "type": "string" } }, { "description": "The JSON Web Key ID (kid)", "in": "path", "name": "kid", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Delete JSON Web Key", "tags": [ "jwk" ], "x-ory-ratelimit-bucket": "hydra-admin-low" }, "get": { "description": "This endpoint returns a singular JSON Web Key contained in a set. It is identified by the set and the specific key ID (kid).", "operationId": "getJsonWebKey", "parameters": [ { "description": "JSON Web Key Set ID", "in": "path", "name": "set", "required": true, "schema": { "type": "string" } }, { "description": "JSON Web Key ID", "in": "path", "name": "kid", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/jsonWebKeySet" } } }, "description": "jsonWebKeySet" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Get JSON Web Key", "tags": [ "jwk" ], "x-ory-ratelimit-bucket": "hydra-admin-medium" }, "put": { "description": "Use this method if you do not want to let Hydra generate the JWKs for you, but instead save your own.\n\nWarning: the key is created or updated under the `kid` given in the request body. The `{kid}` path parameter exists for historical reasons only: it is ignored and not validated against the body.\n\nA JSON Web Key (JWK) is a JavaScript Object Notation (JSON) data structure that represents a cryptographic key. A JWK Set is a JSON data structure that represents a set of JWKs. A JSON Web Key is identified by its set and key id. ORY Hydra uses this functionality to store cryptographic keys used for TLS and JSON Web Tokens (such as OpenID Connect ID tokens), and allows storing user-defined keys as well.", "operationId": "setJsonWebKey", "parameters": [ { "description": "The JSON Web Key Set ID", "in": "path", "name": "set", "required": true, "schema": { "type": "string" } }, { "description": "JSON Web Key ID", "in": "path", "name": "kid", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/jsonWebKey" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/jsonWebKey" } } }, "description": "jsonWebKey" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Set JSON Web Key", "tags": [ "jwk" ], "x-ory-ratelimit-bucket": "hydra-admin-low" } }, "/admin/oauth2/auth/requests/consent": { "get": { "description": "When an authorization code, hybrid, or implicit OAuth 2.0 Flow is initiated, Ory asks the login provider\nto authenticate the subject and then tell Ory now about it. If the subject authenticated, he/she must now be asked if\nthe OAuth 2.0 Client which initiated the flow should be allowed to access the resources on the subject's behalf.\n\nThe consent challenge is appended to the consent provider's URL to which the subject's user-agent (browser) is redirected to. The consent\nprovider uses that challenge to fetch information on the OAuth2 request and then tells Ory if the subject accepted\nor rejected the request.\n\nThe default consent provider is available via the Ory Managed Account Experience. To customize the consent provider, please\nhead over to the OAuth 2.0 documentation.", "operationId": "getOAuth2ConsentRequest", "parameters": [ { "description": "OAuth 2.0 Consent Request Challenge", "in": "query", "name": "consent_challenge", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2ConsentRequest" } } }, "description": "oAuth2ConsentRequest" }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2RedirectTo" } } }, "description": "oAuth2RedirectTo" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Get OAuth 2.0 Consent Request", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-high" } }, "/admin/oauth2/auth/requests/consent/accept": { "put": { "description": "When an authorization code, hybrid, or implicit OAuth 2.0 Flow is initiated, Ory asks the login provider\nto authenticate the subject and then tell Ory now about it. If the subject authenticated, he/she must now be asked if\nthe OAuth 2.0 Client which initiated the flow should be allowed to access the resources on the subject's behalf.\n\nThe consent challenge is appended to the consent provider's URL to which the subject's user-agent (browser) is redirected to. The consent\nprovider uses that challenge to fetch information on the OAuth2 request and then tells Ory if the subject accepted\nor rejected the request.\n\nThis endpoint tells Ory that the subject has authorized the OAuth 2.0 client to access resources on his/her behalf.\nThe consent provider includes additional information, such as session data for access and ID tokens, and if the\nconsent request should be used as basis for future requests.\n\nThe response contains a redirect URL which the consent provider should redirect the user-agent to.\n\nThe default consent provider is available via the Ory Managed Account Experience. To customize the consent provider, please\nhead over to the OAuth 2.0 documentation.", "operationId": "acceptOAuth2ConsentRequest", "parameters": [ { "description": "OAuth 2.0 Consent Request Challenge", "in": "query", "name": "consent_challenge", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/acceptOAuth2ConsentRequest" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2RedirectTo" } } }, "description": "oAuth2RedirectTo" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Accept OAuth 2.0 Consent Request", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-high" } }, "/admin/oauth2/auth/requests/consent/reject": { "put": { "description": "When an authorization code, hybrid, or implicit OAuth 2.0 Flow is initiated, Ory asks the login provider\nto authenticate the subject and then tell Ory now about it. If the subject authenticated, he/she must now be asked if\nthe OAuth 2.0 Client which initiated the flow should be allowed to access the resources on the subject's behalf.\n\nThe consent challenge is appended to the consent provider's URL to which the subject's user-agent (browser) is redirected to. The consent\nprovider uses that challenge to fetch information on the OAuth2 request and then tells Ory if the subject accepted\nor rejected the request.\n\nThis endpoint tells Ory that the subject has not authorized the OAuth 2.0 client to access resources on his/her behalf.\nThe consent provider must include a reason why the consent was not granted.\n\nThe response contains a redirect URL which the consent provider should redirect the user-agent to.\n\nThe default consent provider is available via the Ory Managed Account Experience. To customize the consent provider, please\nhead over to the OAuth 2.0 documentation.", "operationId": "rejectOAuth2ConsentRequest", "parameters": [ { "description": "OAuth 2.0 Consent Request Challenge", "in": "query", "name": "consent_challenge", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/rejectOAuth2Request" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2RedirectTo" } } }, "description": "oAuth2RedirectTo" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Reject OAuth 2.0 Consent Request", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-high" } }, "/admin/oauth2/auth/requests/device/accept": { "put": { "description": "Accepts a device grant user_code request", "operationId": "acceptUserCodeRequest", "parameters": [ { "in": "query", "name": "device_challenge", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/acceptDeviceUserCodeRequest" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2RedirectTo" } } }, "description": "oAuth2RedirectTo" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Accepts a device grant user_code request", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-high" } }, "/admin/oauth2/auth/requests/login": { "get": { "description": "When an authorization code, hybrid, or implicit OAuth 2.0 Flow is initiated, Ory asks the login provider\nto authenticate the subject and then tell the Ory OAuth2 Service about it.\n\nPer default, the login provider is Ory itself. You may use a different login provider which needs to be a web-app\nyou write and host, and it must be able to authenticate (\"show the subject a login screen\")\na subject (in OAuth2 the proper name for subject is \"resource owner\").\n\nThe authentication challenge is appended to the login provider URL to which the subject's user-agent (browser) is redirected to. The login\nprovider uses that challenge to fetch information on the OAuth2 request and then accept or reject the requested authentication process.", "operationId": "getOAuth2LoginRequest", "parameters": [ { "description": "OAuth 2.0 Login Request Challenge", "in": "query", "name": "login_challenge", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2LoginRequest" } } }, "description": "oAuth2LoginRequest" }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2RedirectTo" } } }, "description": "oAuth2RedirectTo" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Get OAuth 2.0 Login Request", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-high" } }, "/admin/oauth2/auth/requests/login/accept": { "put": { "description": "When an authorization code, hybrid, or implicit OAuth 2.0 Flow is initiated, Ory asks the login provider\nto authenticate the subject and then tell the Ory OAuth2 Service about it.\n\nThe authentication challenge is appended to the login provider URL to which the subject's user-agent (browser) is redirected to. The login\nprovider uses that challenge to fetch information on the OAuth2 request and then accept or reject the requested authentication process.\n\nThis endpoint tells Ory that the subject has successfully authenticated and includes additional information such as\nthe subject's ID and if Ory should remember the subject's subject agent for future authentication attempts by setting\na cookie.\n\nThe response contains a redirect URL which the login provider should redirect the user-agent to.", "operationId": "acceptOAuth2LoginRequest", "parameters": [ { "description": "OAuth 2.0 Login Request Challenge", "in": "query", "name": "login_challenge", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/acceptOAuth2LoginRequest" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2RedirectTo" } } }, "description": "oAuth2RedirectTo" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Accept OAuth 2.0 Login Request", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-high" } }, "/admin/oauth2/auth/requests/login/reject": { "put": { "description": "When an authorization code, hybrid, or implicit OAuth 2.0 Flow is initiated, Ory asks the login provider\nto authenticate the subject and then tell the Ory OAuth2 Service about it.\n\nThe authentication challenge is appended to the login provider URL to which the subject's user-agent (browser) is redirected to. The login\nprovider uses that challenge to fetch information on the OAuth2 request and then accept or reject the requested authentication process.\n\nThis endpoint tells Ory that the subject has not authenticated and includes a reason why the authentication\nwas denied.\n\nThe response contains a redirect URL which the login provider should redirect the user-agent to.", "operationId": "rejectOAuth2LoginRequest", "parameters": [ { "description": "OAuth 2.0 Login Request Challenge", "in": "query", "name": "login_challenge", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/rejectOAuth2Request" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2RedirectTo" } } }, "description": "oAuth2RedirectTo" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Reject OAuth 2.0 Login Request", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-high" } }, "/admin/oauth2/auth/requests/logout": { "get": { "description": "Use this endpoint to fetch an Ory OAuth 2.0 logout request.", "operationId": "getOAuth2LogoutRequest", "parameters": [ { "in": "query", "name": "logout_challenge", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2LogoutRequest" } } }, "description": "oAuth2LogoutRequest" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Get OAuth 2.0 Session Logout Request", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-high" } }, "/admin/oauth2/auth/requests/logout/accept": { "put": { "description": "When a user or an application requests Ory OAuth 2.0 to remove the session state of a subject, this endpoint is used to confirm that logout request.\n\nThe response contains a redirect URL which the consent provider should redirect the user-agent to.", "operationId": "acceptOAuth2LogoutRequest", "parameters": [ { "description": "OAuth 2.0 Logout Request Challenge", "in": "query", "name": "logout_challenge", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2RedirectTo" } } }, "description": "oAuth2RedirectTo" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Accept OAuth 2.0 Session Logout Request", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-high" } }, "/admin/oauth2/auth/requests/logout/reject": { "put": { "description": "When a user or an application requests Ory OAuth 2.0 to remove the session state of a subject, this endpoint is used to deny that logout request.\nNo HTTP request body is required.\n\nThe response is empty as the logout provider has to chose what action to perform next.", "operationId": "rejectOAuth2LogoutRequest", "parameters": [ { "in": "query", "name": "logout_challenge", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Reject OAuth 2.0 Session Logout Request", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-high" } }, "/admin/oauth2/auth/sessions/consent": { "delete": { "description": "This endpoint revokes a subject's granted consent sessions and invalidates all\nassociated OAuth 2.0 Access Tokens. You may also only revoke sessions for a specific OAuth 2.0 Client ID.", "operationId": "revokeOAuth2ConsentSessions", "parameters": [ { "description": "OAuth 2.0 Consent Subject\n\nThe subject whose consent sessions should be deleted.", "in": "query", "name": "subject", "schema": { "type": "string" } }, { "description": "OAuth 2.0 Client ID\n\nIf set, deletes only those consent sessions that have been granted to the specified OAuth 2.0 Client ID.", "in": "query", "name": "client", "schema": { "type": "string" } }, { "description": "Consent Request ID\n\nIf set, revoke all token chains derived from this particular consent request ID.", "in": "query", "name": "consent_request_id", "schema": { "type": "string" } }, { "description": "Revoke All Consent Sessions\n\nIf set to `true` deletes all consent sessions by the Subject that have been granted.", "in": "query", "name": "all", "schema": { "type": "boolean" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Revoke OAuth 2.0 Consent Sessions of a Subject", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-low" }, "get": { "description": "This endpoint lists all subject's granted consent sessions, including client and granted scope.\nIf the subject is unknown or has not granted any consent sessions yet, the endpoint returns an\nempty JSON array with status code 200 OK.", "operationId": "listOAuth2ConsentSessions", "parameters": [ { "description": "Items per Page\n\nThis is the number of items per page to return.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_size", "schema": { "default": 250, "format": "int64", "maximum": 500, "minimum": 1, "type": "integer" } }, { "description": "Next Page Token\n\nThe next page token.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_token", "schema": { "type": "string" } }, { "description": "The subject to list the consent sessions for.", "in": "query", "name": "subject", "required": true, "schema": { "type": "string" } }, { "description": "The login session id to list the consent sessions for.", "in": "query", "name": "login_session_id", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2ConsentSessions" } } }, "description": "oAuth2ConsentSessions" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "List OAuth 2.0 Consent Sessions of a Subject", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-high" } }, "/admin/oauth2/auth/sessions/login": { "delete": { "description": "This endpoint invalidates authentication sessions. After revoking the authentication session(s), the subject\nhas to re-authenticate at the Ory OAuth2 Provider. This endpoint does not invalidate any tokens.\n\nIf you send the subject in a query param, all authentication sessions that belong to that subject are revoked.\nNo OpenID Connect Front- or Back-channel logout is performed in this case.\n\nAlternatively, you can send a SessionID via `sid` query param, in which case, only the session that is connected\nto that SessionID is revoked. OpenID Connect Back-channel logout is performed in this case.\n\nWhen using Ory for the identity provider, the login provider will also invalidate the session cookie.", "operationId": "revokeOAuth2LoginSessions", "parameters": [ { "description": "OAuth 2.0 Subject\n\nThe subject to revoke authentication sessions for.", "in": "query", "name": "subject", "schema": { "type": "string" } }, { "description": "Login Session ID\n\nThe login session to revoke.", "in": "query", "name": "sid", "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Revokes OAuth 2.0 Login Sessions by either a Subject or a SessionID", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-low" } }, "/admin/oauth2/introspect": { "post": { "description": "The introspection endpoint allows to check if a token (both refresh and access) is active or not. An active token\nis neither expired nor revoked. If a token is active, additional information on the token will be included. You can\nset additional data for a token by setting `session.access_token` during the consent flow.", "operationId": "introspectOAuth2Token", "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "properties": { "scope": { "description": "An optional, space separated list of required scopes. If the access token was not granted one of the\nscopes, the result of active will be false.", "type": "string", "x-formData-name": "scope" }, "token": { "description": "The string value of the token. For access tokens, this\nis the \"access_token\" value returned from the token endpoint\ndefined in OAuth 2.0. For refresh tokens, this is the \"refresh_token\"\nvalue returned.", "required": [ "token" ], "type": "string", "x-formData-name": "token" } }, "required": [ "token" ], "type": "object" } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/introspectedOAuth2Token" } } }, "description": "introspectedOAuth2Token" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Introspect OAuth2 Access and Refresh Tokens", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-high" } }, "/admin/oauth2/tokens": { "delete": { "description": "This endpoint deletes OAuth2 access tokens issued to an OAuth 2.0 Client from the database.", "operationId": "deleteOAuth2Token", "parameters": [ { "description": "OAuth 2.0 Client ID", "in": "query", "name": "client_id", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Delete OAuth 2.0 Access Tokens from specific OAuth 2.0 Client", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-low" } }, "/admin/recovery/code": { "post": { "description": "This endpoint creates a recovery code which should be given to the user in order for them to recover\n(or activate) their account.", "operationId": "createRecoveryCodeForIdentity", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/createRecoveryCodeForIdentityBody" } } }, "x-originalParamName": "Body" }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/recoveryCodeForIdentity" } } }, "description": "recoveryCodeForIdentity" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Create a Recovery Code", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-low" } }, "/admin/recovery/link": { "post": { "description": "This endpoint creates a recovery link which should be given to the user in order for them to recover\n(or activate) their account.", "operationId": "createRecoveryLinkForIdentity", "parameters": [ { "in": "query", "name": "return_to", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/createRecoveryLinkForIdentityBody" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/recoveryLinkForIdentity" } } }, "description": "recoveryLinkForIdentity" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Create a Recovery Link", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-low" } }, "/admin/relation-tuples": { "delete": { "description": "Use this endpoint to delete relationships", "operationId": "deleteRelationships", "parameters": [ { "description": "Namespace of the Relationship", "in": "query", "name": "namespace", "schema": { "type": "string" } }, { "description": "Object of the Relationship", "in": "query", "name": "object", "schema": { "type": "string" } }, { "description": "Relation of the Relationship", "in": "query", "name": "relation", "schema": { "type": "string" } }, { "description": "SubjectID of the Relationship", "in": "query", "name": "subject_id", "schema": { "type": "string" } }, { "description": "Namespace of the Subject Set", "in": "query", "name": "subject_set.namespace", "schema": { "type": "string" } }, { "description": "Object of the Subject Set", "in": "query", "name": "subject_set.object", "schema": { "type": "string" } }, { "description": "Relation of the Subject Set", "in": "query", "name": "subject_set.relation", "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Delete Relationships", "tags": [ "relationship" ], "x-ory-ratelimit-bucket": "keto-admin-low" }, "patch": { "description": "Use this endpoint to patch one or more relationships.", "operationId": "patchRelationships", "requestBody": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/relationshipPatch" }, "type": "array" } } }, "x-originalParamName": "Body" }, "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Patch Multiple Relationships", "tags": [ "relationship" ], "x-ory-ratelimit-bucket": "keto-admin-low" }, "put": { "description": "Use this endpoint to create a relationship.", "operationId": "createRelationship", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/createRelationshipBody" } } }, "x-originalParamName": "Body" }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/relationship" } } }, "description": "relationship" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Create a Relationship", "tags": [ "relationship" ], "x-ory-ratelimit-bucket": "keto-admin-low" } }, "/admin/sessions": { "get": { "description": "Listing all sessions that exist.", "operationId": "listSessions", "parameters": [ { "description": "Items per Page\n\nThis is the number of items per page to return.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_size", "schema": { "default": 250, "format": "int64", "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "Next Page Token\n\nThe next page token.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_token", "schema": { "type": "string" } }, { "description": "Active is a boolean flag that filters out sessions based on the state. If no value is provided, all sessions are returned.", "in": "query", "name": "active", "schema": { "type": "boolean" } }, { "description": "ExpandOptions is a query parameter encoded list of all properties that must be expanded in the Session.\nIf no value is provided, the expandable properties are skipped.", "in": "query", "name": "expand", "schema": { "items": { "enum": [ "identity", "devices" ], "type": "string" }, "type": "array" } } ], "responses": { "200": { "$ref": "#/components/responses/listSessions" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "List All Sessions", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-medium" }, "post": { "description": "Disable or delete sessions for a list of identities or a list of sessions in\na single call. The `action` field selects the operation:\n\n`disable` — deactivate matching sessions (sets `active = false`, preserves\naudit data).\n`delete` — permanently delete matching sessions.\n\nExactly one of `identities` or `sessions` must be provided. To scope the\noperation to every session in the network, pass `identities: [\"*\"]`; the\nwildcard is not accepted in the `sessions` field. Up to 500 explicit IDs\nare accepted per call.\n\nAll requests return `200 OK` with `{processed, more}`. `processed` reports\nhow many rows the call affected; for `disable` it counts only sessions\nthat were active before the call. `more` is `true` only when a wildcard\nrequest reached the per-call batch limit and additional rows may remain;\ncallers drain the network by re-issuing the same request while `more` is\n`true`. Explicit-IDs requests always return `more: false`.", "operationId": "manageSessions", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/manageSessionsBody" } } }, "required": true, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/manageSessionsResponse" } } }, "description": "manageSessionsResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Manage sessions in bulk", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-low" } }, "/admin/sessions/{id}": { "delete": { "description": "Calling this endpoint deactivates the specified session. Session data is not deleted.", "operationId": "disableSession", "parameters": [ { "description": "ID is the session's ID.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Deactivate a Session", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-low" }, "get": { "description": "This endpoint is useful for:\n\nGetting a session object with all specified expandables that exist in an administrative context.", "operationId": "getSession", "parameters": [ { "description": "ExpandOptions is a query parameter encoded list of all properties that must be expanded in the Session.\nExample - ?expand=Identity\u0026expand=Devices\nIf no value is provided, the expandable properties are skipped.", "in": "query", "name": "expand", "schema": { "items": { "enum": [ "identity", "devices" ], "type": "string" }, "type": "array" } }, { "description": "ID is the session's ID.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/session" } } }, "description": "session" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Get Session", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-high" } }, "/admin/sessions/{id}/extend": { "patch": { "description": "Calling this endpoint extends the given session ID. If `session.earliest_possible_extend` is set it\nwill only extend the session after the specified time has passed.\n\nThis endpoint returns per default a 204 No Content response on success. Older Ory Network projects may\nreturn a 200 OK response with the session in the body. Returning the session as part of the response\nwill be deprecated in the future and should not be relied upon.\n\nThis endpoint ignores consecutive requests to extend the same session and returns a 404 error in those\nscenarios. This endpoint also returns 404 errors if the session does not exist.\n\nRetrieve the session ID from the `/sessions/whoami` endpoint / `toSession` SDK method.", "operationId": "extendSession", "parameters": [ { "description": "ID is the session's ID.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/session" } } }, "description": "session" }, "204": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Extend a Session", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-low" } }, "/admin/test-login-flows": { "post": { "description": "Creates a dry-run OIDC test login flow pre-scoped to one provider. The\nreturned flow carries a single-submit UI and a CSRF bearer token. No\nidentity is persisted and no session is issued when the flow completes;\nthe captured debug data is returned in the flow's test_context.", "operationId": "createTestLoginFlow", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/createTestLoginFlowBody" } } }, "required": true, "x-originalParamName": "Body" }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/loginFlow" } } }, "description": "loginFlow" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Create a test OIDC login flow", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-low" } }, "/admin/trust/grants/jwt-bearer/issuers": { "get": { "description": "Use this endpoint to list all trusted JWT Bearer Grant Type Issuers.", "operationId": "listTrustedOAuth2JwtGrantIssuers", "parameters": [ { "description": "Items per Page\n\nThis is the number of items per page to return.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_size", "schema": { "default": 250, "format": "int64", "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "Next Page Token\n\nThe next page token.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_token", "schema": { "type": "string" } }, { "description": "If optional \"issuer\" is supplied, only jwt-bearer grants with this issuer will be returned.", "in": "query", "name": "issuer", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/trustedOAuth2JwtGrantIssuers" } } }, "description": "trustedOAuth2JwtGrantIssuers" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" } }, "security": [ { "oryAccessToken": [] } ], "summary": "List Trusted OAuth2 JWT Bearer Grant Type Issuers", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-medium" }, "post": { "description": "Use this endpoint to establish a trust relationship for a JWT issuer\nto perform JSON Web Token (JWT) Profile for OAuth 2.0 Client Authentication\nand Authorization Grants [RFC7523](https://datatracker.ietf.org/doc/html/rfc7523).", "operationId": "trustOAuth2JwtGrantIssuer", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/trustOAuth2JwtGrantIssuer" } } }, "x-originalParamName": "Body" }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/trustedOAuth2JwtGrantIssuer" } } }, "description": "trustedOAuth2JwtGrantIssuer" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Trust OAuth2 JWT Bearer Grant Type Issuer", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-low" } }, "/admin/trust/grants/jwt-bearer/issuers/{id}": { "delete": { "description": "Use this endpoint to delete trusted JWT Bearer Grant Type Issuer. The ID is the one returned when you\ncreated the trust relationship.\n\nOnce deleted, the associated issuer will no longer be able to perform the JSON Web Token (JWT) Profile\nfor OAuth 2.0 Client Authentication and Authorization Grant.", "operationId": "deleteTrustedOAuth2JwtGrantIssuer", "parameters": [ { "description": "The id of the desired grant", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Delete Trusted OAuth2 JWT Bearer Grant Type Issuer", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-low" }, "get": { "description": "Use this endpoint to get a trusted JWT Bearer Grant Type Issuer. The ID is the one returned when you\ncreated the trust relationship.", "operationId": "getTrustedOAuth2JwtGrantIssuer", "parameters": [ { "description": "The id of the desired grant", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/trustedOAuth2JwtGrantIssuer" } } }, "description": "trustedOAuth2JwtGrantIssuer" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Get Trusted OAuth2 JWT Bearer Grant Type Issuer", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-medium" } }, "/credentials": { "post": { "description": "This endpoint creates a verifiable credential that attests that the user\nauthenticated with the provided access token owns a certain public/private key\npair.\n\nMore information can be found at\nhttps://openid.net/specs/openid-connect-userinfo-vc-1_0.html.", "operationId": "createVerifiableCredential", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateVerifiableCredentialRequestBody" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/verifiableCredentialResponse" } } }, "description": "verifiableCredentialResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/verifiableCredentialPrimingResponse" } } }, "description": "verifiableCredentialPrimingResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "summary": "Issues a Verifiable Credential", "tags": [ "oidc" ], "x-ory-ratelimit-bucket": "hydra-admin-medium" } }, "/elements/configuration": { "get": { "description": "Returns a subset of the project's configuration for the given host.\nThe response only contains non-sensitive data that is used to customize the behavior of Ory Elements.", "operationId": "getConfiguration", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/elementsConfiguration" } } }, "description": "elementsConfiguration" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" } }, "summary": "Get Ory Elements configuration", "tags": [ "elements" ] } }, "/namespaces": { "get": { "description": "Get all namespaces", "operationId": "listRelationshipNamespaces", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/relationshipNamespaces" } } }, "description": "relationshipNamespaces" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Query namespaces", "tags": [ "relationship" ], "x-ory-ratelimit-bucket": "keto-admin-low" } }, "/oauth2/auth": { "get": { "description": "Use open source libraries to perform OAuth 2.0 and OpenID Connect\navailable for any programming language. You can find a list of libraries at https://oauth.net/code/\n\nThis endpoint should not be used via the Ory SDK and is only included for technical reasons.\nInstead, use one of the libraries linked above.", "operationId": "oAuth2Authorize", "responses": { "302": { "$ref": "#/components/responses/emptyResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "summary": "OAuth 2.0 Authorize Endpoint", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-public-medium" } }, "/oauth2/device/auth": { "post": { "description": "This endpoint is not documented here because you should never use your own implementation to perform OAuth2 flows.\nOAuth2 is a very popular protocol and a library for your programming language will exist.\n\nTo learn more about this flow please refer to the specification: https://tools.ietf.org/html/rfc8628", "operationId": "oAuth2DeviceFlow", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/deviceAuthorization" } } }, "description": "deviceAuthorization" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "summary": "The OAuth 2.0 Device Authorize Endpoint", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-public-high" } }, "/oauth2/device/verify": { "get": { "description": "This is the device user verification endpoint. The user is redirected here when trying to log in using the device flow.", "operationId": "performOAuth2DeviceVerificationFlow", "responses": { "302": { "$ref": "#/components/responses/emptyResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "summary": "OAuth 2.0 Device Verification Endpoint", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-admin-high" } }, "/oauth2/register": { "post": { "description": "This endpoint behaves like the administrative counterpart (`createOAuth2Client`) but is capable of facing the\npublic internet directly and can be used in self-service. It implements the OpenID Connect\nDynamic Client Registration Protocol. This feature needs to be enabled in the configuration. This endpoint\nis disabled by default. It can be enabled by an administrator.\n\nPlease note that using this endpoint you are not able to choose the `client_secret` nor the `client_id` as those\nvalues will be server generated when specifying `token_endpoint_auth_method` as `client_secret_basic` or\n`client_secret_post`.\n\nThe `client_secret` will be returned in the response and you will not be able to retrieve it later on.\nWrite the secret down and keep it somewhere safe.", "operationId": "createOidcDynamicClient", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2Client" } } }, "description": "Dynamic Client Registration Request Body", "required": true, "x-originalParamName": "Body" }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2Client" } } }, "description": "oAuth2Client" }, "400": { "$ref": "#/components/responses/errorOAuth2BadRequest" }, "default": { "$ref": "#/components/responses/errorOAuth2Default" } }, "summary": "Register OAuth2 Client using OpenID Dynamic Client Registration", "tags": [ "oidc" ], "x-ory-ratelimit-bucket": "hydra-public-low" } }, "/oauth2/register/{id}": { "delete": { "description": "This endpoint behaves like the administrative counterpart (`deleteOAuth2Client`) but is capable of facing the\npublic internet directly and can be used in self-service. It implements the OpenID Connect\nDynamic Client Registration Protocol. This feature needs to be enabled in the configuration. This endpoint\nis disabled by default. It can be enabled by an administrator.\n\nTo use this endpoint, you will need to present the client's authentication credentials. If the OAuth2 Client\nuses the Token Endpoint Authentication Method `client_secret_post`, you need to present the client secret in the URL query.\nIf it uses `client_secret_basic`, present the Client ID and the Client Secret in the Authorization header.\n\nOAuth 2.0 clients are used to perform OAuth 2.0 and OpenID Connect flows. Usually, OAuth 2.0 clients are\ngenerated for applications which want to consume your OAuth 2.0 or OpenID Connect capabilities.", "operationId": "deleteOidcDynamicClient", "parameters": [ { "description": "The id of the OAuth 2.0 Client.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" } }, "security": [ { "bearer": [] } ], "summary": "Delete OAuth 2.0 Client using the OpenID Dynamic Client Registration Management Protocol", "tags": [ "oidc" ], "x-ory-ratelimit-bucket": "hydra-public-low" }, "get": { "description": "This endpoint behaves like the administrative counterpart (`getOAuth2Client`) but is capable of facing the\npublic internet directly and can be used in self-service. It implements the OpenID Connect\nDynamic Client Registration Protocol.\n\nTo use this endpoint, you will need to present the client's authentication credentials. If the OAuth2 Client\nuses the Token Endpoint Authentication Method `client_secret_post`, you need to present the client secret in the URL query.\nIf it uses `client_secret_basic`, present the Client ID and the Client Secret in the Authorization header.", "operationId": "getOidcDynamicClient", "parameters": [ { "description": "The id of the OAuth 2.0 Client.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2Client" } } }, "description": "oAuth2Client" }, "default": { "$ref": "#/components/responses/errorOAuth2Default" } }, "security": [ { "bearer": [] } ], "summary": "Get OAuth2 Client using OpenID Dynamic Client Registration", "tags": [ "oidc" ], "x-ory-ratelimit-bucket": "hydra-admin-high" }, "put": { "description": "This endpoint behaves like the administrative counterpart (`setOAuth2Client`) but is capable of facing the\npublic internet directly to be used by third parties. It implements the OpenID Connect\nDynamic Client Registration Protocol.\n\nThis feature is disabled per default. It can be enabled by a system administrator.\n\nIf you pass `client_secret` the secret is used, otherwise the existing secret is used. If set, the secret is echoed in the response.\nIt is not possible to retrieve it later on.\n\nTo use this endpoint, you will need to present the client's authentication credentials. If the OAuth2 Client\nuses the Token Endpoint Authentication Method `client_secret_post`, you need to present the client secret in the URL query.\nIf it uses `client_secret_basic`, present the Client ID and the Client Secret in the Authorization header.\n\nOAuth 2.0 clients are used to perform OAuth 2.0 and OpenID Connect flows. Usually, OAuth 2.0 clients are\ngenerated for applications which want to consume your OAuth 2.0 or OpenID Connect capabilities.", "operationId": "setOidcDynamicClient", "parameters": [ { "description": "OAuth 2.0 Client ID", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2Client" } } }, "description": "OAuth 2.0 Client Request Body", "required": true, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2Client" } } }, "description": "oAuth2Client" }, "404": { "$ref": "#/components/responses/errorOAuth2NotFound" }, "default": { "$ref": "#/components/responses/errorOAuth2Default" } }, "security": [ { "bearer": [] } ], "summary": "Set OAuth2 Client using OpenID Dynamic Client Registration", "tags": [ "oidc" ], "x-ory-ratelimit-bucket": "hydra-public-low" } }, "/oauth2/revoke": { "post": { "description": "Revoking a token (both access and refresh) means that the tokens will be invalid. A revoked access token can no\nlonger be used to make access requests, and a revoked refresh token can no longer be used to refresh an access token.\nRevoking a refresh token also invalidates the access token that was created with it. A token may only be revoked by\nthe client the token was generated for.", "operationId": "revokeOAuth2Token", "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "properties": { "client_id": { "type": "string", "x-formData-name": "client_id" }, "client_secret": { "type": "string", "x-formData-name": "client_secret" }, "token": { "required": [ "token" ], "type": "string", "x-formData-name": "token" } }, "required": [ "token" ], "type": "object" } } } }, "responses": { "200": { "$ref": "#/components/responses/emptyResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "basic": [] }, { "oauth2": [] } ], "summary": "Revoke OAuth 2.0 Access or Refresh Token", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-public-medium" } }, "/oauth2/sessions/logout": { "get": { "description": "This endpoint initiates and completes user logout at the Ory OAuth2 \u0026 OpenID provider and initiates OpenID Connect Front- / Back-channel logout:\n\nhttps://openid.net/specs/openid-connect-frontchannel-1_0.html\nhttps://openid.net/specs/openid-connect-backchannel-1_0.html\n\nBack-channel logout is performed asynchronously and does not affect logout flow.", "operationId": "revokeOidcSession", "responses": { "302": { "$ref": "#/components/responses/emptyResponse" } }, "summary": "OpenID Connect Front- and Back-channel Enabled Logout", "tags": [ "oidc" ], "x-ory-ratelimit-bucket": "hydra-public-medium" } }, "/oauth2/token": { "post": { "description": "Use open source libraries to perform OAuth 2.0 and OpenID Connect\navailable for any programming language. You can find a list of libraries here https://oauth.net/code/\n\nThis endpoint should not be used via the Ory SDK and is only included for technical reasons.\nInstead, use one of the libraries linked above.", "operationId": "oauth2TokenExchange", "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "properties": { "client_id": { "type": "string", "x-formData-name": "client_id" }, "code": { "type": "string", "x-formData-name": "code" }, "grant_type": { "required": [ "grant_type" ], "type": "string", "x-formData-name": "grant_type" }, "redirect_uri": { "type": "string", "x-formData-name": "redirect_uri" }, "refresh_token": { "type": "string", "x-formData-name": "refresh_token" } }, "required": [ "grant_type" ], "type": "object" } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oAuth2TokenExchange" } } }, "description": "oAuth2TokenExchange" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "basic": [] }, { "oauth2": [] } ], "summary": "The OAuth 2.0 Token Endpoint", "tags": [ "oAuth2" ], "x-ory-ratelimit-bucket": "hydra-public-medium" } }, "/opl/syntax/check": { "post": { "description": "The OPL file is expected in the body of the request.", "operationId": "checkOplSyntax", "requestBody": { "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/checkOplSyntaxBody" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/checkOplSyntaxResult" } } }, "description": "checkOplSyntaxResult" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Check the syntax of an OPL file", "tags": [ "relationship" ], "x-ory-ratelimit-bucket": "keto-admin-medium" } }, "/projects": { "get": { "description": "Lists all projects you have access to.", "operationId": "listProjects", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/projectMetadataList" } } }, "description": "projectMetadataList" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "List All Projects", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" }, "post": { "description": "Creates a new project.", "operationId": "createProject", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/createProjectBody" } } }, "x-originalParamName": "Body" }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/project" } } }, "description": "project" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Create a Project", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" } }, "/projects/{project_id}": { "delete": { "description": "!! Use with extreme caution !!\n\nUsing this API endpoint you can purge (completely delete) a project and its data.\nThis action can not be undone and will delete ALL your data.\n\nCalling this endpoint will additionally delete custom domains and other related data.\n\nIf the project is linked to a subscription, the subscription needs to be unlinked first.", "operationId": "purgeProject", "parameters": [ { "description": "Project ID\n\nThe project's ID.", "in": "path", "name": "project_id", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Irrecoverably purge a project", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" }, "get": { "description": "Get a project you have access to by its ID.", "operationId": "getProject", "parameters": [ { "description": "Project ID\n\nThe project's ID.", "in": "path", "name": "project_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/project" } } }, "description": "project" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Get a Project", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-medium" }, "patch": { "description": "Deprecated: Use the `patchProjectWithRevision` endpoint instead to specify the exact revision the patch was generated for.\n\nThis endpoints allows you to patch individual Ory Network project configuration keys for\nOry's services (identity, permission, ...). The configuration format is fully compatible\nwith the open source projects for the respective services (e.g. Ory Kratos for Identity, Ory Keto for Permissions).\n\nThis endpoint expects the `version` key to be set in the payload. If it is unset, it\nwill try to import the config as if it is from the most recent version.\n\nIf you have an older version of a configuration, you should set the version key in the payload!\n\nWhile this endpoint is able to process all configuration items related to features (e.g. password reset),\nit does not support operational configuration items (e.g. port, tracing, logging) otherwise available in the\nopen source.\n\nFor configuration items that can not be translated to the Ory Network, this endpoint will return a list of warnings\nto help you understand which parts of your config could not be processed.", "operationId": "patchProject", "parameters": [ { "description": "Project ID\n\nThe project's ID.", "in": "path", "name": "project_id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/jsonPatch" }, "type": "array" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/successfulProjectUpdate" } } }, "description": "successfulProjectUpdate" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Patch an Ory Network Project Configuration", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" }, "put": { "description": "This endpoints allows you to update the Ory Network project configuration for\nindividual services (identity, permission, ...). The configuration is fully compatible\nwith the open source projects for the respective services (e.g. Ory Kratos for Identity, Ory Keto for Permissions).\n\nThis endpoint expects the `version` key to be set in the payload. If it is unset, it\nwill try to import the config as if it is from the most recent version.\n\nIf you have an older version of a configuration, you should set the version key in the payload!\n\nWhile this endpoint is able to process all configuration items related to features (e.g. password reset),\nit does not support operational configuration items (e.g. port, tracing, logging) otherwise available in the\nopen source.\n\nFor configuration items that can not be translated to the Ory Network, this endpoint will return a list of warnings\nto help you understand which parts of your config could not be processed.\n\nBe aware that updating any service's configuration will completely override your current configuration for that\nservice!", "operationId": "setProject", "parameters": [ { "description": "Project ID\n\nThe project's ID.", "in": "path", "name": "project_id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/setProject" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/successfulProjectUpdate" } } }, "description": "successfulProjectUpdate" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Update an Ory Network Project Configuration", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" } }, "/projects/{project_id}/eventstreams": { "get": { "operationId": "listEventStreams", "parameters": [ { "description": "Project ID\n\nThe project's ID.", "in": "path", "name": "project_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/listEventStreams" } } }, "description": "listEventStreams" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "List all event streams for the project. This endpoint is not paginated.", "tags": [ "events" ], "x-ory-ratelimit-bucket": "backoffice-admin-medium" }, "post": { "operationId": "createEventStream", "parameters": [ { "description": "Project ID\n\nThe project's ID.", "in": "path", "name": "project_id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/createEventStreamBody" } } }, "required": true, "x-originalParamName": "Body" }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/eventStream" } } }, "description": "eventStream" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Create an event stream for your project.", "tags": [ "events" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" } }, "/projects/{project_id}/eventstreams/{event_stream_id}": { "delete": { "description": "Remove an event stream from a project.", "operationId": "deleteEventStream", "parameters": [ { "description": "Project ID\n\nThe project's ID.", "in": "path", "name": "project_id", "required": true, "schema": { "type": "string" } }, { "description": "Event Stream ID\n\nThe ID of the event stream to be deleted, as returned when created.", "in": "path", "name": "event_stream_id", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Remove an event stream from a project", "tags": [ "events" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" }, "put": { "operationId": "setEventStream", "parameters": [ { "description": "Project ID\n\nThe project's ID.", "in": "path", "name": "project_id", "required": true, "schema": { "type": "string" } }, { "description": "Event Stream ID\n\nThe event stream's ID.", "in": "path", "name": "event_stream_id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/setEventStreamBody" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/eventStream" } } }, "description": "eventStream" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Update an event stream for a project.", "tags": [ "events" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" } }, "/projects/{project_id}/organizations": { "get": { "description": "Deprecated: use getProject instead\n\nLists all Enterprise SSO organizations in a project.", "operationId": "listOrganizations", "parameters": [ { "description": "Items per Page\n\nThis is the number of items per page to return.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_size", "schema": { "default": 250, "format": "int64", "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "Next Page Token\n\nThe next page token.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_token", "schema": { "type": "string" } }, { "description": "Project ID\n\nThe project's ID.", "in": "path", "name": "project_id", "required": true, "schema": { "type": "string" } }, { "description": "Domain\n\nIf set, only organizations with that domain will be returned.", "in": "query", "name": "domain", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/listOrganizationsResponse" } } }, "description": "listOrganizationsResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "List all Enterprise SSO organizations", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-medium" }, "post": { "description": "Deprecated: use setProject or patchProjectWithRevision instead\n\nCreates an Enterprise SSO Organization in a project.", "operationId": "createOrganization", "parameters": [ { "description": "Project ID\n\nThe project's ID.", "in": "path", "name": "project_id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrganizationBody" } } }, "x-originalParamName": "Body" }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/organization" } } }, "description": "organization" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Create an Enterprise SSO Organization", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" } }, "/projects/{project_id}/organizations/{organization_id}": { "delete": { "description": "Deprecated: use setProject or patchProjectWithRevision instead\n\nIrrecoverably deletes an Enterprise SSO Organization in a project by its ID.", "operationId": "deleteOrganization", "parameters": [ { "description": "Project ID\n\nThe project's ID.", "in": "path", "name": "project_id", "required": true, "schema": { "type": "string" } }, { "description": "Organization ID\n\nThe Organization's ID.", "in": "path", "name": "organization_id", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Delete Enterprise SSO Organization", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" }, "get": { "description": "Deprecated: use getProject instead\n\nRetrieves an Enterprise SSO Organization for a project by its ID", "operationId": "getOrganization", "parameters": [ { "description": "Project ID\n\nThe project's ID.", "in": "path", "name": "project_id", "required": true, "schema": { "type": "string" } }, { "description": "Organization ID\n\nThe Organization's ID.", "in": "path", "name": "organization_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/getOrganizationResponse" } } }, "description": "getOrganizationResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Get Enterprise SSO Organization by ID", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-medium" }, "put": { "description": "Deprecated: use setProject or patchProjectWithRevision instead\n\nUpdates an Enterprise SSO Organization in a project by its ID.", "operationId": "updateOrganization", "parameters": [ { "description": "Project ID\n\nThe project's ID.", "in": "path", "name": "project_id", "required": true, "schema": { "type": "string" } }, { "description": "Organization ID\n\nThe Organization's ID.", "in": "path", "name": "organization_id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrganizationBody" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/organization" } } }, "description": "organization" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Update an Enterprise SSO Organization", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" } }, "/projects/{project_id}/organizations/{organization_id}/onboarding-portal-links": { "get": { "description": "Retrieves the organization onboarding portal links.", "operationId": "getOrganizationOnboardingPortalLinks", "parameters": [ { "description": "Project ID\n\nThe project's ID.", "in": "path", "name": "project_id", "required": true, "schema": { "type": "string" } }, { "description": "Organization ID\n\nThe Organization's ID.", "in": "path", "name": "organization_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/organizationOnboardingPortalLinksResponse" } } }, "description": "organizationOnboardingPortalLinksResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Get the organization onboarding portal links", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-medium" }, "post": { "description": "Create a onboarding portal link for an organization.", "operationId": "createOrganizationOnboardingPortalLink", "parameters": [ { "description": "Project ID\n\nThe project's ID.", "in": "path", "name": "project_id", "required": true, "schema": { "type": "string" } }, { "description": "Organization ID\n\nThe Organization's ID.", "in": "path", "name": "organization_id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/createOrganizationOnboardingPortalLinkBody" } } }, "x-originalParamName": "Body" }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/onboardingPortalLink" } } }, "description": "onboardingPortalLink" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Create organization onboarding portal link", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" } }, "/projects/{project_id}/organizations/{organization_id}/onboarding-portal-links/{onboarding_portal_link_id}": { "delete": { "description": "Deletes a onboarding portal link for an organization.", "operationId": "deleteOrganizationOnboardingPortalLink", "parameters": [ { "in": "path", "name": "project_id", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "organization_id", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "onboarding_portal_link_id", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Delete an organization onboarding portal link", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" }, "post": { "description": "Update a onboarding portal link for an organization.", "operationId": "updateOrganizationOnboardingPortalLink", "parameters": [ { "description": "Project ID\n\nThe project's ID.", "in": "path", "name": "project_id", "required": true, "schema": { "type": "string" } }, { "description": "Organization ID\n\nThe Organization's ID.", "in": "path", "name": "organization_id", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "onboarding_portal_link_id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/updateOrganizationOnboardingPortalLinkBody" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/onboardingPortalLink" } } }, "description": "onboardingPortalLink" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Update organization onboarding portal link", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" } }, "/projects/{project_id}/revision/{revision_id}": { "patch": { "description": "This endpoints allows you to patch individual Ory Network Project configuration keys for\nOry's services (identity, permission, ...). The configuration format is fully compatible\nwith the open source projects for the respective services (e.g. Ory Kratos for Identity, Ory Keto for Permissions).\n\nThis endpoint expects the `version` key to be set in the payload. If it is unset, it\nwill try to import the config as if it is from the most recent version.\n\nIf you have an older version of a configuration, you should set the version key in the payload!\n\nWhile this endpoint is able to process all configuration items related to features (e.g. password reset),\nit does not support operational configuration items (e.g. port, tracing, logging) otherwise available in the\nopen source.\n\nFor configuration items that can not be translated to the Ory Network, this endpoint will return a list of warnings\nto help you understand which parts of your config could not be processed.", "operationId": "patchProjectWithRevision", "parameters": [ { "description": "Project ID\n\nThe project's ID.", "in": "path", "name": "project_id", "required": true, "schema": { "type": "string" } }, { "description": "Revision ID\n\nThe revision ID that this patch was generated for.", "in": "path", "name": "revision_id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/jsonPatch" }, "type": "array" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/successfulProjectUpdate" } } }, "description": "successfulProjectUpdate" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Patch an Ory Network Project Configuration based on a revision ID", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" } }, "/projects/{project}/members": { "get": { "description": "This endpoint requires the user to be a member of the project with the role `OWNER` or `DEVELOPER`.", "operationId": "getProjectMembers", "parameters": [ { "in": "path", "name": "project", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/projectMembers" } } }, "description": "projectMembers" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" }, "406": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Get all members associated with this project", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" } }, "/projects/{project}/members/{member}": { "delete": { "description": "This also sets their invite status to `REMOVED`.\nThis endpoint requires the user to be a member of the project with the role `OWNER`.", "operationId": "removeProjectMember", "parameters": [ { "in": "path", "name": "project", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "member", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" }, "406": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/genericError" } } }, "description": "genericError" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Remove a member associated with this project", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" } }, "/projects/{project}/tokens": { "get": { "description": "A list of all the project's API keys.", "operationId": "listProjectApiKeys", "parameters": [ { "description": "The Project ID or Project slug", "in": "path", "name": "project", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/projectApiKeys" } } }, "description": "projectApiKeys" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "List a project's API keys", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" }, "post": { "description": "Create an API key for a project.", "operationId": "createProjectApiKey", "parameters": [ { "description": "The Project ID or Project slug", "in": "path", "name": "project", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/createProjectApiKeyBody" } } }, "x-originalParamName": "Body" }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/projectApiKey" } } }, "description": "projectApiKey" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Create project API key", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" } }, "/projects/{project}/tokens/{token_id}": { "delete": { "description": "Deletes an API key and immediately removes it.", "operationId": "deleteProjectApiKey", "parameters": [ { "description": "The Project ID or Project slug", "in": "path", "name": "project", "required": true, "schema": { "type": "string" } }, { "description": "The Token ID", "in": "path", "name": "token_id", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Delete project API key", "tags": [ "project" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" } }, "/relation-tuples": { "get": { "description": "Get all relationships that match the query. Only the namespace field is required.", "operationId": "getRelationships", "parameters": [ { "description": "Items per Page\n\nThis is the number of items per page to return.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_size", "schema": { "default": 250, "format": "int64", "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "Next Page Token\n\nThe next page token.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_token", "schema": { "type": "string" } }, { "description": "Namespace of the Relationship", "in": "query", "name": "namespace", "schema": { "type": "string" } }, { "description": "Object of the Relationship", "in": "query", "name": "object", "schema": { "type": "string" } }, { "description": "Relation of the Relationship", "in": "query", "name": "relation", "schema": { "type": "string" } }, { "description": "SubjectID of the Relationship", "in": "query", "name": "subject_id", "schema": { "type": "string" } }, { "description": "Namespace of the Subject Set", "in": "query", "name": "subject_set.namespace", "schema": { "type": "string" } }, { "description": "Object of the Subject Set", "in": "query", "name": "subject_set.object", "schema": { "type": "string" } }, { "description": "Relation of the Subject Set", "in": "query", "name": "subject_set.relation", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/relationships" } } }, "description": "relationships" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Query relationships", "tags": [ "relationship" ], "x-ory-ratelimit-bucket": "keto-admin-medium" } }, "/relation-tuples/batch/check": { "post": { "description": "To learn how relationship tuples and the check works, head over to [the documentation](https://www.ory.com/docs/keto/concepts/api-overview).", "operationId": "batchCheckPermission", "parameters": [ { "in": "query", "name": "max-depth", "schema": { "format": "int64", "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/batchCheckPermissionBody" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/batchCheckPermissionResult" } } }, "description": "batchCheckPermissionResult" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Batch check permissions", "tags": [ "permission" ], "x-ory-ratelimit-bucket": "keto-public-high" } }, "/relation-tuples/check": { "get": { "description": "To learn how relationship tuples and the check works, head over to [the documentation](https://www.ory.com/docs/keto/concepts/api-overview).", "operationId": "checkPermissionOrError", "parameters": [ { "description": "Namespace of the Relationship", "in": "query", "name": "namespace", "schema": { "type": "string" } }, { "description": "Object of the Relationship", "in": "query", "name": "object", "schema": { "type": "string" } }, { "description": "Relation of the Relationship", "in": "query", "name": "relation", "schema": { "type": "string" } }, { "description": "SubjectID of the Relationship", "in": "query", "name": "subject_id", "schema": { "type": "string" } }, { "description": "Namespace of the Subject Set", "in": "query", "name": "subject_set.namespace", "schema": { "type": "string" } }, { "description": "Object of the Subject Set", "in": "query", "name": "subject_set.object", "schema": { "type": "string" } }, { "description": "Relation of the Subject Set", "in": "query", "name": "subject_set.relation", "schema": { "type": "string" } }, { "in": "query", "name": "max-depth", "schema": { "format": "int64", "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/checkPermissionResult" } } }, "description": "checkPermissionResult" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/checkPermissionResult" } } }, "description": "checkPermissionResult" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Check a permission", "tags": [ "permission" ], "x-ory-ratelimit-bucket": "keto-public-high" }, "post": { "description": "To learn how relationship tuples and the check works, head over to [the documentation](https://www.ory.com/docs/keto/concepts/api-overview).", "operationId": "postCheckPermissionOrError", "parameters": [ { "in": "query", "name": "max-depth", "schema": { "format": "int64", "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/postCheckPermissionOrErrorBody" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/checkPermissionResult" } } }, "description": "checkPermissionResult" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/checkPermissionResult" } } }, "description": "checkPermissionResult" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Check a permission", "tags": [ "permission" ], "x-ory-ratelimit-bucket": "keto-public-high" } }, "/relation-tuples/check/openapi": { "get": { "description": "To learn how relationship tuples and the check works, head over to [the documentation](https://www.ory.com/docs/keto/concepts/api-overview).", "operationId": "checkPermission", "parameters": [ { "description": "Namespace of the Relationship", "in": "query", "name": "namespace", "schema": { "type": "string" } }, { "description": "Object of the Relationship", "in": "query", "name": "object", "schema": { "type": "string" } }, { "description": "Relation of the Relationship", "in": "query", "name": "relation", "schema": { "type": "string" } }, { "description": "SubjectID of the Relationship", "in": "query", "name": "subject_id", "schema": { "type": "string" } }, { "description": "Namespace of the Subject Set", "in": "query", "name": "subject_set.namespace", "schema": { "type": "string" } }, { "description": "Object of the Subject Set", "in": "query", "name": "subject_set.object", "schema": { "type": "string" } }, { "description": "Relation of the Subject Set", "in": "query", "name": "subject_set.relation", "schema": { "type": "string" } }, { "in": "query", "name": "max-depth", "schema": { "format": "int64", "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/checkPermissionResult" } } }, "description": "checkPermissionResult" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Check a permission", "tags": [ "permission" ], "x-ory-ratelimit-bucket": "keto-public-high" }, "post": { "description": "To learn how relationship tuples and the check works, head over to [the documentation](https://www.ory.com/docs/keto/concepts/api-overview).", "operationId": "postCheckPermission", "parameters": [ { "in": "query", "name": "max-depth", "schema": { "format": "int64", "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/postCheckPermissionBody" } } }, "x-originalParamName": "Payload" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/checkPermissionResult" } } }, "description": "checkPermissionResult" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Check a permission", "tags": [ "permission" ], "x-ory-ratelimit-bucket": "keto-public-high" } }, "/relation-tuples/expand": { "get": { "description": "Use this endpoint to expand a relationship tuple into permissions.", "operationId": "expandPermissions", "parameters": [ { "description": "Namespace of the Subject Set", "in": "query", "name": "namespace", "required": true, "schema": { "type": "string" } }, { "description": "Object of the Subject Set", "in": "query", "name": "object", "required": true, "schema": { "type": "string" } }, { "description": "Relation of the Subject Set", "in": "query", "name": "relation", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "max-depth", "schema": { "format": "int64", "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/expandedPermissionTree" } } }, "description": "expandedPermissionTree" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryAccessToken": [] } ], "summary": "Expand a Relationship into permissions.", "tags": [ "permission" ], "x-ory-ratelimit-bucket": "keto-admin-medium" } }, "/schemas": { "get": { "description": "Returns a list of all identity schemas currently in use.", "operationId": "listIdentitySchemas", "parameters": [ { "description": "Deprecated Items per Page\n\nDEPRECATED: Please use `page_token` instead. This parameter will be removed in the future.\n\nThis is the number of items per page.", "in": "query", "name": "per_page", "schema": { "default": 250, "format": "int64", "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "Deprecated Pagination Page\n\nDEPRECATED: Please use `page_token` instead. This parameter will be removed in the future.\n\nThis value is currently an integer, but it is not sequential. The value is not the page number, but a\nreference. The next page can be any number and some numbers might return an empty list.\n\nFor example, page 2 might not follow after page 1. And even if page 3 and 5 exist, but page 4 might not exist.\nThe first page can be retrieved by omitting this parameter. Following page pointers will be returned in the\n`Link` header.", "in": "query", "name": "page", "schema": { "format": "int64", "type": "integer" } }, { "description": "Page Size\n\nThis is the number of items per page to return. For details on pagination please head over to the\n[pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_size", "schema": { "default": 250, "format": "int64", "maximum": 500, "minimum": 1, "type": "integer" } }, { "description": "Next Page Token\n\nThe next page token. For details on pagination please head over to the\n[pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_token", "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/identitySchemas" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Get all Identity Schemas", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-medium" } }, "/schemas/{id}": { "get": { "description": "Return a specific identity schema.", "operationId": "getIdentitySchema", "parameters": [ { "description": "ID must be set to the ID of schema you want to get", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/identitySchema" } } }, "description": "identitySchema" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Get Identity JSON Schema", "tags": [ "identity" ], "x-ory-ratelimit-bucket": "kratos-admin-medium" } }, "/self-service/errors": { "get": { "description": "This endpoint returns the error associated with a user-facing self service errors.\n\nThis endpoint supports stub values to help you implement the error UI:\n\n`?id=stub:500` - returns a stub 500 (Internal Server Error) error.\n\nMore information can be found at [Ory Kratos User User Facing Error Documentation](https://www.ory.com/docs/kratos/self-service/flows/user-facing-errors).", "operationId": "getFlowError", "parameters": [ { "description": "Error is the error's ID", "in": "query", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/flowError" } } }, "description": "flowError" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Get User-Flow Errors", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-high" } }, "/self-service/fed-cm/parameters": { "get": { "description": "This endpoint returns a list of all available FedCM providers. It is only supported on the Ory Network.", "operationId": "createFedcmFlow", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/createFedcmFlowResponse" } } }, "description": "createFedcmFlowResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Get FedCM Parameters", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-high" } }, "/self-service/fed-cm/token": { "post": { "description": "Use this endpoint to submit a token from a FedCM provider through\n`navigator.credentials.get` and log the user in. The parameters from\n`navigator.credentials.get` must have come from `GET\nself-service/fed-cm/parameters`.", "operationId": "updateFedcmFlow", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateFedcmFlowBody" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/UpdateFedcmFlowBody" } } }, "required": true, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/successfulNativeLogin" } } }, "description": "successfulNativeLogin" }, "303": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/loginFlow" } } }, "description": "loginFlow" }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorBrowserLocationChangeRequired" } } }, "description": "errorBrowserLocationChangeRequired" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Submit a FedCM token", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-low" } }, "/self-service/login": { "post": { "description": "Use this endpoint to complete a login flow. This endpoint\nbehaves differently for API and browser flows.\n\nAPI flows expect `application/json` to be sent in the body and responds with\nHTTP 200 and a application/json body with the session token on success;\nHTTP 410 if the original flow expired with the appropriate error messages set and optionally a `use_flow_id` parameter in the body;\nHTTP 400 on form validation errors.\n\nBrowser flows expect a Content-Type of `application/x-www-form-urlencoded` or `application/json` to be sent in the body and respond with\na HTTP 303 redirect to the post/after login URL or the `return_to` value if it was set and if the login succeeded;\na HTTP 303 redirect to the login UI URL with the flow ID containing the validation errors otherwise.\n\nBrowser flows with an accept header of `application/json` will not redirect but instead respond with\nHTTP 200 and a application/json body with the signed in identity and a `Set-Cookie` header on success;\nHTTP 303 redirect to a fresh login flow if the original flow expired with the appropriate error messages set;\nHTTP 400 on form validation errors.\n\nIf this endpoint is called with `Accept: application/json` in the header, the response contains the flow without a redirect. In the\ncase of an error, the `error.id` of the JSON response body can be one of:\n\n`session_already_available`: The user is already signed in.\n`security_csrf_violation`: Unable to fetch the flow because a CSRF violation occurred.\n`security_identity_mismatch`: The requested `?return_to` address is not allowed to be used. Adjust this in the configuration!\n`browser_location_change_required`: Usually sent when an AJAX request indicates that the browser needs to open a specific URL.\nMost likely used in Social Sign In flows.\n\nMore information can be found at [Ory Kratos User Login](https://www.ory.com/docs/kratos/self-service/flows/user-login) and [User Registration Documentation](https://www.ory.com/docs/kratos/self-service/flows/user-registration).", "operationId": "updateLoginFlow", "parameters": [ { "description": "The Login Flow ID\n\nThe value for this parameter comes from `flow` URL Query parameter sent to your\napplication (e.g. `/login?flow=abcde`).", "in": "query", "name": "flow", "required": true, "schema": { "type": "string" } }, { "description": "The Session Token of the Identity performing the settings flow.", "in": "header", "name": "X-Session-Token", "schema": { "type": "string" } }, { "description": "HTTP Cookies\n\nWhen using the SDK in a browser app, on the server side you must include the HTTP Cookie Header\nsent by the client to your server here. This ensures that CSRF and session cookies are respected.", "in": "header", "name": "Cookie", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/updateLoginFlowBody" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/updateLoginFlowBody" } } }, "required": true, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/successfulNativeLogin" } } }, "description": "successfulNativeLogin" }, "303": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/loginFlow" } } }, "description": "loginFlow" }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorBrowserLocationChangeRequired" } } }, "description": "errorBrowserLocationChangeRequired" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Submit a Login Flow", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-low" } }, "/self-service/login/api": { "get": { "description": "This endpoint initiates a login flow for native apps that do not use a browser, such as mobile devices, smart TVs, and so on.\n\nIf a valid provided session cookie or session token is provided, a 400 Bad Request error\nwill be returned unless the URL query parameter `?refresh=true` is set.\n\nTo fetch an existing login flow call `/self-service/login/flows?flow=\u003cflow_id\u003e`.\n\nYou MUST NOT use this endpoint in client-side (Single Page Apps, ReactJS, AngularJS) nor server-side (Java Server\nPages, NodeJS, PHP, Golang, ...) browser applications. Using this endpoint in these applications will make\nyou vulnerable to a variety of CSRF attacks, including CSRF login attacks.\n\nIn the case of an error, the `error.id` of the JSON response body can be one of:\n\n`session_already_available`: The user is already signed in.\n`session_aal1_required`: Multi-factor auth (e.g. 2fa) was requested but the user has no session yet.\n`security_csrf_violation`: Unable to fetch the flow because a CSRF violation occurred.\n\nThis endpoint MUST ONLY be used in scenarios such as native mobile apps (React Native, Objective C, Swift, Java, ...).\n\nMore information can be found at [Ory Kratos User Login](https://www.ory.com/docs/kratos/self-service/flows/user-login) and [User Registration Documentation](https://www.ory.com/docs/kratos/self-service/flows/user-registration).", "operationId": "createNativeLoginFlow", "parameters": [ { "description": "Refresh a login session\n\nIf set to true, this will refresh an existing login session by\nasking the user to sign in again. This will reset the\nauthenticated_at time of the session.", "in": "query", "name": "refresh", "schema": { "type": "boolean" } }, { "description": "Request a Specific AuthenticationMethod Assurance Level\n\nUse this parameter to upgrade an existing session's authenticator assurance level (AAL). This\nallows you to ask for multi-factor authentication. When an identity sign in using e.g. username+password,\nthe AAL is 1. If you wish to \"upgrade\" the session's security by asking the user to perform TOTP / WebAuth/ ...\nyou would set this to \"aal2\".", "in": "query", "name": "aal", "schema": { "type": "string" } }, { "description": "The Session Token of the Identity performing the settings flow.", "in": "header", "name": "X-Session-Token", "schema": { "type": "string" } }, { "description": "EnableSessionTokenExchangeCode requests the login flow to include a code that can be used to retrieve the session token\nafter the login flow has been completed.", "in": "query", "name": "return_session_token_exchange_code", "schema": { "type": "boolean" } }, { "description": "The URL to return the browser to after the flow was completed.", "in": "query", "name": "return_to", "schema": { "type": "string" } }, { "description": "An optional organization ID that should be used for logging this user in.\nThis parameter is only effective in the Ory Network.", "in": "query", "name": "organization", "schema": { "type": "string" } }, { "description": "Via should contain the identity's credential the code should be sent to. Only relevant in aal2 flows.\n\nDEPRECATED: This field is deprecated. Please remove it from your requests. The user will now see a choice\nof MFA credentials to choose from to perform the second factor instead.", "in": "query", "name": "via", "schema": { "type": "string" } }, { "description": "An optional identity schema to use for the login flow.", "in": "query", "name": "identity_schema", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/loginFlow" } } }, "description": "loginFlow" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Create Login Flow for Native Apps", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-medium" } }, "/self-service/login/browser": { "get": { "description": "This endpoint initializes a browser-based user login flow. This endpoint will set the appropriate\ncookies and anti-CSRF measures required for browser-based flows.\n\nIf this endpoint is opened as a link in the browser, it will be redirected to\n`selfservice.flows.login.ui_url` with the flow ID set as the query parameter `?flow=`. If a valid user session\nexists already, the browser will be redirected to `urls.default_redirect_url` unless the query parameter\n`?refresh=true` was set.\n\nIf this endpoint is called via an AJAX request, the response contains the flow without a redirect. In the\ncase of an error, the `error.id` of the JSON response body can be one of:\n\n`session_already_available`: The user is already signed in.\n`session_aal1_required`: Multi-factor auth (e.g. 2fa) was requested but the user has no session yet.\n`security_csrf_violation`: Unable to fetch the flow because a CSRF violation occurred.\n`security_identity_mismatch`: The requested `?return_to` address is not allowed to be used. Adjust this in the configuration!\n\nThe optional query parameter login_challenge is set when using Kratos with\nHydra in an OAuth2 flow. See the oauth2_provider.url configuration\noption.\n\nThis endpoint is NOT INTENDED for clients that do not have a browser (Chrome, Firefox, ...) as cookies are needed.\n\nMore information can be found at [Ory Kratos User Login](https://www.ory.com/docs/kratos/self-service/flows/user-login) and [User Registration Documentation](https://www.ory.com/docs/kratos/self-service/flows/user-registration).", "operationId": "createBrowserLoginFlow", "parameters": [ { "description": "Refresh a login session\n\nIf set to true, this will refresh an existing login session by\nasking the user to sign in again. This will reset the\nauthenticated_at time of the session.", "in": "query", "name": "refresh", "schema": { "type": "boolean" } }, { "description": "Request a Specific AuthenticationMethod Assurance Level\n\nUse this parameter to upgrade an existing session's authenticator assurance level (AAL). This\nallows you to ask for multi-factor authentication. When an identity sign in using e.g. username+password,\nthe AAL is 1. If you wish to \"upgrade\" the session's security by asking the user to perform TOTP / WebAuth/ ...\nyou would set this to \"aal2\".", "in": "query", "name": "aal", "schema": { "type": "string" } }, { "description": "The URL to return the browser to after the flow was completed.", "in": "query", "name": "return_to", "schema": { "type": "string" } }, { "description": "HTTP Cookies\n\nWhen using the SDK in a browser app, on the server side you must include the HTTP Cookie Header\nsent by the client to your server here. This ensures that CSRF and session cookies are respected.", "in": "header", "name": "Cookie", "schema": { "type": "string" } }, { "description": "An optional Hydra login challenge. If present, Kratos will cooperate with\nOry Hydra to act as an OAuth2 identity provider.\n\nThe value for this parameter comes from `login_challenge` URL Query parameter sent to your\napplication (e.g. `/login?login_challenge=abcde`).", "in": "query", "name": "login_challenge", "schema": { "type": "string" } }, { "description": "An optional organization ID that should be used for logging this user in.\nThis parameter is only effective in the Ory Network.", "in": "query", "name": "organization", "schema": { "type": "string" } }, { "description": "Via should contain the identity's credential the code should be sent to. Only relevant in aal2 flows.\n\nDEPRECATED: This field is deprecated. Please remove it from your requests. The user will now see a choice\nof MFA credentials to choose from to perform the second factor instead.", "in": "query", "name": "via", "schema": { "type": "string" } }, { "description": "An optional identity schema to use for the login flow.", "in": "query", "name": "identity_schema", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/loginFlow" } } }, "description": "loginFlow" }, "303": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Create Login Flow for Browsers", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-medium" } }, "/self-service/login/flows": { "get": { "description": "This endpoint returns a login flow's context with, for example, error details and other information.\n\nBrowser flows expect the anti-CSRF cookie to be included in the request's HTTP Cookie Header.\nFor AJAX requests you must ensure that cookies are included in the request or requests will fail.\n\nIf you use the browser-flow for server-side apps, the services need to run on a common top-level-domain\nand you need to forward the incoming HTTP Cookie header to this endpoint:\n\n```js\npseudo-code example\nrouter.get('/login', async function (req, res) {\nconst flow = await client.getLoginFlow(req.header('cookie'), req.query['flow'])\n\nres.render('login', flow)\n})\n```\n\nThis request may fail due to several reasons. The `error.id` can be one of:\n\n`session_already_available`: The user is already signed in.\n`self_service_flow_expired`: The flow is expired and you should request a new one.\n\nMore information can be found at [Ory Kratos User Login](https://www.ory.com/docs/kratos/self-service/flows/user-login) and [User Registration Documentation](https://www.ory.com/docs/kratos/self-service/flows/user-registration).", "operationId": "getLoginFlow", "parameters": [ { "description": "The Login Flow ID\n\nThe value for this parameter comes from `flow` URL Query parameter sent to your\napplication (e.g. `/login?flow=abcde`).", "in": "query", "name": "id", "required": true, "schema": { "type": "string" } }, { "description": "HTTP Cookies\n\nWhen using the SDK in a browser app, on the server side you must include the HTTP Cookie Header\nsent by the client to your server here. This ensures that CSRF and session cookies are respected.", "in": "header", "name": "Cookie", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/loginFlow" } } }, "description": "loginFlow" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Get Login Flow", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-high" } }, "/self-service/login/test": { "delete": { "description": "Deletes a dry-run OIDC test login flow. A flow whose debug payload has\nbeen captured requires the HMAC cookie set by the OIDC callback; a flow\nstill in the initial choose-method state is deletable with just the flow\nID (it carries no PII, and the admin may want to abandon it).", "operationId": "deleteTestLoginFlow", "parameters": [ { "description": "ID of the test login flow to delete.", "in": "query", "name": "id", "required": true, "schema": { "type": "string" } }, { "description": "HTTP Cookies. A captured test flow requires the ory_kratos_test_flow\ncookie set by the OIDC callback; a flow still in the initial\nchoose-method state does not.", "in": "header", "name": "Cookie", "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Delete a test OIDC login flow", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-high" } }, "/self-service/logout": { "get": { "description": "This endpoint logs out an identity in a self-service manner.\n\nIf the `Accept` HTTP header is not set to `application/json`, the browser will be redirected (HTTP 303 See Other)\nto the `return_to` parameter of the initial request or fall back to `urls.default_return_to`.\n\nIf the `Accept` HTTP header is set to `application/json`, a 204 No Content response\nwill be sent on successful logout instead.\n\nThis endpoint is NOT INTENDED for API clients and only works\nwith browsers (Chrome, Firefox, ...). For API clients you can\ncall the `/self-service/logout/api` URL directly with the Ory Session Token.\n\nMore information can be found at [Ory Kratos User Logout Documentation](https://www.ory.com/docs/next/kratos/self-service/flows/user-logout).", "operationId": "updateLogoutFlow", "parameters": [ { "description": "A Valid Logout Token\n\nIf you do not have a logout token because you only have a session cookie,\ncall `/self-service/logout/browser` to generate a URL for this endpoint.", "in": "query", "name": "token", "schema": { "type": "string" } }, { "description": "The URL to return to after the logout was completed.", "in": "query", "name": "return_to", "schema": { "type": "string" } }, { "description": "HTTP Cookies\n\nWhen using the SDK in a browser app, on the server side you must include the HTTP Cookie Header\nsent by the client to your server here. This ensures that CSRF and session cookies are respected.", "in": "header", "name": "Cookie", "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "303": { "$ref": "#/components/responses/emptyResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Update Logout Flow", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-high" } }, "/self-service/logout/api": { "delete": { "description": "Use this endpoint to log out an identity using an Ory Session Token. If the Ory Session Token was successfully\nrevoked, the server returns a 204 No Content response. A 204 No Content response is also sent when\nthe Ory Session Token has been revoked already before.\n\nIf the Ory Session Token is malformed or does not exist a 403 Forbidden response will be returned.\n\nThis endpoint does not remove any HTTP\nCookies - use the Browser-Based Self-Service Logout Flow instead.", "operationId": "performNativeLogout", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/performNativeLogoutBody" } } }, "required": true, "x-originalParamName": "Body" }, "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Perform Logout for Native Apps", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-medium" } }, "/self-service/logout/browser": { "get": { "description": "This endpoint initializes a browser-based user logout flow and a URL which can be used to log out the user.\n\nThis endpoint is NOT INTENDED for API clients and only works\nwith browsers (Chrome, Firefox, ...). For API clients you can\ncall the `/self-service/logout/api` URL directly with the Ory Session Token.\n\nThe URL is only valid for the currently signed in user. If no user is signed in, this endpoint returns\na 401 error.\n\nWhen calling this endpoint from a backend, please ensure to properly forward the HTTP cookies.", "operationId": "createBrowserLogoutFlow", "parameters": [ { "description": "HTTP Cookies\n\nIf you call this endpoint from a backend, please include the\noriginal Cookie header in the request.", "in": "header", "name": "cookie", "schema": { "type": "string" } }, { "description": "Return to URL\n\nThe URL to which the browser should be redirected to after the logout\nhas been performed.", "in": "query", "name": "return_to", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/logoutFlow" } } }, "description": "logoutFlow" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Create a Logout URL for Browsers", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-medium" } }, "/self-service/recovery": { "post": { "description": "Use this endpoint to update a recovery flow. This endpoint\nbehaves differently for API and browser flows and has several states:\n\n`choose_method` expects `flow` (in the URL query) and `email` (in the body) to be sent\nand works with API- and Browser-initiated flows.\nFor API clients and Browser clients with HTTP Header `Accept: application/json` it either returns a HTTP 200 OK when the form is valid and HTTP 400 OK when the form is invalid.\nand a HTTP 303 See Other redirect with a fresh recovery flow if the flow was otherwise invalid (e.g. expired).\nFor Browser clients without HTTP Header `Accept` or with `Accept: text/*` it returns a HTTP 303 See Other redirect to the Recovery UI URL with the Recovery Flow ID appended.\n`sent_email` is the success state after `choose_method` for the `link` method and allows the user to request another recovery email. It\nworks for both API and Browser-initiated flows and returns the same responses as the flow in `choose_method` state.\n`passed_challenge` expects a `token` to be sent in the URL query and given the nature of the flow (\"sending a recovery link\")\ndoes not have any API capabilities. The server responds with a HTTP 303 See Other redirect either to the Settings UI URL\n(if the link was valid) and instructs the user to update their password, or a redirect to the Recover UI URL with\na new Recovery Flow ID which contains an error message that the recovery link was invalid.\n\nMore information can be found at [Ory Kratos Account Recovery Documentation](../self-service/flows/account-recovery).", "operationId": "updateRecoveryFlow", "parameters": [ { "description": "The Recovery Flow ID\n\nThe value for this parameter comes from `flow` URL Query parameter sent to your\napplication (e.g. `/recovery?flow=abcde`).", "in": "query", "name": "flow", "required": true, "schema": { "type": "string" } }, { "description": "Recovery Token\n\nThe recovery token which completes the recovery request. If the token\nis invalid (e.g. expired) an error will be shown to the end-user.\n\nThis parameter is usually set in a link and not used by any direct API call.", "in": "query", "name": "token", "schema": { "type": "string" } }, { "description": "HTTP Cookies\n\nWhen using the SDK in a browser app, on the server side you must include the HTTP Cookie Header\nsent by the client to your server here. This ensures that CSRF and session cookies are respected.", "in": "header", "name": "Cookie", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/updateRecoveryFlowBody" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/updateRecoveryFlowBody" } } }, "required": true, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/recoveryFlow" } } }, "description": "recoveryFlow" }, "303": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/recoveryFlow" } } }, "description": "recoveryFlow" }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorBrowserLocationChangeRequired" } } }, "description": "errorBrowserLocationChangeRequired" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Update Recovery Flow", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-low" } }, "/self-service/recovery/api": { "get": { "description": "This endpoint initiates a recovery flow for API clients such as mobile devices, smart TVs, and so on.\n\nIf a valid provided session cookie or session token is provided, a 400 Bad Request error.\n\nOn an existing recovery flow, use the `getRecoveryFlow` API endpoint.\n\nYou MUST NOT use this endpoint in client-side (Single Page Apps, ReactJS, AngularJS) nor server-side (Java Server\nPages, NodeJS, PHP, Golang, ...) browser applications. Using this endpoint in these applications will make\nyou vulnerable to a variety of CSRF attacks.\n\nThis endpoint MUST ONLY be used in scenarios such as native mobile apps (React Native, Objective C, Swift, Java, ...).\n\nMore information can be found at [Ory Kratos Account Recovery Documentation](../self-service/flows/account-recovery).", "operationId": "createNativeRecoveryFlow", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/recoveryFlow" } } }, "description": "recoveryFlow" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Create Recovery Flow for Native Apps", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-medium" } }, "/self-service/recovery/browser": { "get": { "description": "This endpoint initializes a browser-based account recovery flow. Once initialized, the browser will be redirected to\n`selfservice.flows.recovery.ui_url` with the flow ID set as the query parameter `?flow=`. If a valid user session\nexists, the browser is returned to the configured return URL.\n\nIf this endpoint is called via an AJAX request, the response contains the recovery flow without any redirects\nor a 400 bad request error if the user is already authenticated.\n\nThis endpoint is NOT INTENDED for clients that do not have a browser (Chrome, Firefox, ...) as cookies are needed.\n\nMore information can be found at [Ory Kratos Account Recovery Documentation](../self-service/flows/account-recovery).", "operationId": "createBrowserRecoveryFlow", "parameters": [ { "description": "The URL to return the browser to after the flow was completed.", "in": "query", "name": "return_to", "schema": { "type": "string" } }, { "description": "Skip redirection to the settings UI after the recovery flow was\ncompleted. Instead, the user will be redirected to the URL specified in\n`return_to` query parameter or the default return URL if `return_to` is\nnot set.", "in": "query", "name": "skip_settings", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/recoveryFlow" } } }, "description": "recoveryFlow" }, "303": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Create Recovery Flow for Browsers", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-medium" } }, "/self-service/recovery/flows": { "get": { "description": "This endpoint returns a recovery flow's context with, for example, error details and other information.\n\nBrowser flows expect the anti-CSRF cookie to be included in the request's HTTP Cookie Header.\nFor AJAX requests you must ensure that cookies are included in the request or requests will fail.\n\nIf you use the browser-flow for server-side apps, the services need to run on a common top-level-domain\nand you need to forward the incoming HTTP Cookie header to this endpoint:\n\n```js\npseudo-code example\nrouter.get('/recovery', async function (req, res) {\nconst flow = await client.getRecoveryFlow(req.header('Cookie'), req.query['flow'])\n\nres.render('recovery', flow)\n})\n```\n\nMore information can be found at [Ory Kratos Account Recovery Documentation](../self-service/flows/account-recovery).", "operationId": "getRecoveryFlow", "parameters": [ { "description": "The Flow ID\n\nThe value for this parameter comes from `request` URL Query parameter sent to your\napplication (e.g. `/recovery?flow=abcde`).", "in": "query", "name": "id", "required": true, "schema": { "type": "string" } }, { "description": "HTTP Cookies\n\nWhen using the SDK in a browser app, on the server side you must include the HTTP Cookie Header\nsent by the client to your server here. This ensures that CSRF and session cookies are respected.", "in": "header", "name": "Cookie", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/recoveryFlow" } } }, "description": "recoveryFlow" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Get Recovery Flow", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-high" } }, "/self-service/registration": { "post": { "description": "Use this endpoint to complete a registration flow by sending an identity's traits and password. This endpoint\nbehaves differently for API and browser flows.\n\nAPI flows expect `application/json` to be sent in the body and respond with\nHTTP 200 and a application/json body with the created identity success - if the session hook is configured the\n`session` and `session_token` will also be included;\nHTTP 410 if the original flow expired with the appropriate error messages set and optionally a `use_flow_id` parameter in the body;\nHTTP 400 on form validation errors.\n\nBrowser flows expect a Content-Type of `application/x-www-form-urlencoded` or `application/json` to be sent in the body and respond with\na HTTP 303 redirect to the post/after registration URL or the `return_to` value if it was set and if the registration succeeded;\na HTTP 303 redirect to the registration UI URL with the flow ID containing the validation errors otherwise.\n\nBrowser flows with an accept header of `application/json` will not redirect but instead respond with\nHTTP 200 and a application/json body with the signed in identity and a `Set-Cookie` header on success;\nHTTP 303 redirect to a fresh login flow if the original flow expired with the appropriate error messages set;\nHTTP 400 on form validation errors.\n\nIf this endpoint is called with `Accept: application/json` in the header, the response contains the flow without a redirect. In the\ncase of an error, the `error.id` of the JSON response body can be one of:\n\n`session_already_available`: The user is already signed in.\n`security_csrf_violation`: Unable to fetch the flow because a CSRF violation occurred.\n`security_identity_mismatch`: The requested `?return_to` address is not allowed to be used. Adjust this in the configuration!\n`browser_location_change_required`: Usually sent when an AJAX request indicates that the browser needs to open a specific URL.\nMost likely used in Social Sign In flows.\n\nMore information can be found at [Ory Kratos User Login](https://www.ory.com/docs/kratos/self-service/flows/user-login) and [User Registration Documentation](https://www.ory.com/docs/kratos/self-service/flows/user-registration).", "operationId": "updateRegistrationFlow", "parameters": [ { "description": "The Registration Flow ID\n\nThe value for this parameter comes from `flow` URL Query parameter sent to your\napplication (e.g. `/registration?flow=abcde`).", "in": "query", "name": "flow", "required": true, "schema": { "type": "string" } }, { "description": "HTTP Cookies\n\nWhen using the SDK in a browser app, on the server side you must include the HTTP Cookie Header\nsent by the client to your server here. This ensures that CSRF and session cookies are respected.", "in": "header", "name": "Cookie", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/updateRegistrationFlowBody" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/updateRegistrationFlowBody" } } }, "required": true, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/successfulNativeRegistration" } } }, "description": "successfulNativeRegistration" }, "303": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/registrationFlow" } } }, "description": "registrationFlow" }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorBrowserLocationChangeRequired" } } }, "description": "errorBrowserLocationChangeRequired" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Update Registration Flow", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-low" } }, "/self-service/registration/api": { "get": { "description": "This endpoint initiates a registration flow for API clients such as mobile devices, smart TVs, and so on.\n\nIf a valid provided session cookie or session token is provided, a 400 Bad Request error\nwill be returned unless the URL query parameter `?refresh=true` is set.\n\nTo fetch an existing registration flow call `/self-service/registration/flows?flow=\u003cflow_id\u003e`.\n\nYou MUST NOT use this endpoint in client-side (Single Page Apps, ReactJS, AngularJS) nor server-side (Java Server\nPages, NodeJS, PHP, Golang, ...) browser applications. Using this endpoint in these applications will make\nyou vulnerable to a variety of CSRF attacks.\n\nIn the case of an error, the `error.id` of the JSON response body can be one of:\n\n`session_already_available`: The user is already signed in.\n`security_csrf_violation`: Unable to fetch the flow because a CSRF violation occurred.\n\nThis endpoint MUST ONLY be used in scenarios such as native mobile apps (React Native, Objective C, Swift, Java, ...).\n\nMore information can be found at [Ory Kratos User Login](https://www.ory.com/docs/kratos/self-service/flows/user-login) and [User Registration Documentation](https://www.ory.com/docs/kratos/self-service/flows/user-registration).", "operationId": "createNativeRegistrationFlow", "parameters": [ { "description": "EnableSessionTokenExchangeCode requests the login flow to include a code that can be used to retrieve the session token\nafter the login flow has been completed.", "in": "query", "name": "return_session_token_exchange_code", "schema": { "type": "boolean" } }, { "description": "The URL to return the browser to after the flow was completed.", "in": "query", "name": "return_to", "schema": { "type": "string" } }, { "description": "An optional organization ID that should be used to register this user.\nThis parameter is only effective in the Ory Network.", "in": "query", "name": "organization", "schema": { "type": "string" } }, { "description": "An optional identity schema to use for the registration flow.", "in": "query", "name": "identity_schema", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/registrationFlow" } } }, "description": "registrationFlow" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Create Registration Flow for Native Apps", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-medium" } }, "/self-service/registration/browser": { "get": { "description": "This endpoint initializes a browser-based user registration flow. This endpoint will set the appropriate\ncookies and anti-CSRF measures required for browser-based flows.\n\nIf this endpoint is opened as a link in the browser, it will be redirected to\n`selfservice.flows.registration.ui_url` with the flow ID set as the query parameter `?flow=`. If a valid user session\nexists already, the browser will be redirected to `urls.default_redirect_url`.\n\nIf this endpoint is called via an AJAX request, the response contains the flow without a redirect. In the\ncase of an error, the `error.id` of the JSON response body can be one of:\n\n`session_already_available`: The user is already signed in.\n`security_csrf_violation`: Unable to fetch the flow because a CSRF violation occurred.\n`security_identity_mismatch`: The requested `?return_to` address is not allowed to be used. Adjust this in the configuration!\n\nIf this endpoint is called via an AJAX request, the response contains the registration flow without a redirect.\n\nThis endpoint is NOT INTENDED for clients that do not have a browser (Chrome, Firefox, ...) as cookies are needed.\n\nMore information can be found at [Ory Kratos User Login](https://www.ory.com/docs/kratos/self-service/flows/user-login) and [User Registration Documentation](https://www.ory.com/docs/kratos/self-service/flows/user-registration).", "operationId": "createBrowserRegistrationFlow", "parameters": [ { "description": "The URL to return the browser to after the flow was completed.", "in": "query", "name": "return_to", "schema": { "type": "string" } }, { "description": "Ory OAuth 2.0 Login Challenge.\n\nIf set will cooperate with Ory OAuth2 and OpenID to act as an OAuth2 server / OpenID Provider.\n\nThe value for this parameter comes from `login_challenge` URL Query parameter sent to your\napplication (e.g. `/registration?login_challenge=abcde`).\n\nThis feature is compatible with Ory Hydra when not running on the Ory Network.", "in": "query", "name": "login_challenge", "schema": { "type": "string" } }, { "description": "The URL to return the browser to after the verification flow was completed.\n\nAfter the registration flow is completed, the user will be sent a verification email.\nUpon completing the verification flow, this URL will be used to override the default\n`selfservice.flows.verification.after.default_redirect_to` value.", "in": "query", "name": "after_verification_return_to", "schema": { "type": "string" } }, { "description": "An optional organization ID that should be used to register this user.\nThis parameter is only effective in the Ory Network.", "in": "query", "name": "organization", "schema": { "type": "string" } }, { "description": "An optional identity schema to use for the registration flow.", "in": "query", "name": "identity_schema", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/registrationFlow" } } }, "description": "registrationFlow" }, "303": { "$ref": "#/components/responses/emptyResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Create Registration Flow for Browsers", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-medium" } }, "/self-service/registration/flows": { "get": { "description": "This endpoint returns a registration flow's context with, for example, error details and other information.\n\nBrowser flows expect the anti-CSRF cookie to be included in the request's HTTP Cookie Header.\nFor AJAX requests you must ensure that cookies are included in the request or requests will fail.\n\nIf you use the browser-flow for server-side apps, the services need to run on a common top-level-domain\nand you need to forward the incoming HTTP Cookie header to this endpoint:\n\n```js\npseudo-code example\nrouter.get('/registration', async function (req, res) {\nconst flow = await client.getRegistrationFlow(req.header('cookie'), req.query['flow'])\n\nres.render('registration', flow)\n})\n```\n\nThis request may fail due to several reasons. The `error.id` can be one of:\n\n`session_already_available`: The user is already signed in.\n`self_service_flow_expired`: The flow is expired and you should request a new one.\n\nMore information can be found at [Ory Kratos User Login](https://www.ory.com/docs/kratos/self-service/flows/user-login) and [User Registration Documentation](https://www.ory.com/docs/kratos/self-service/flows/user-registration).", "operationId": "getRegistrationFlow", "parameters": [ { "description": "The Registration Flow ID\n\nThe value for this parameter comes from `flow` URL Query parameter sent to your\napplication (e.g. `/registration?flow=abcde`).", "in": "query", "name": "id", "required": true, "schema": { "type": "string" } }, { "description": "HTTP Cookies\n\nWhen using the SDK in a browser app, on the server side you must include the HTTP Cookie Header\nsent by the client to your server here. This ensures that CSRF and session cookies are respected.", "in": "header", "name": "Cookie", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/registrationFlow" } } }, "description": "registrationFlow" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Get Registration Flow", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-high" } }, "/self-service/settings": { "post": { "description": "Use this endpoint to complete a settings flow by sending an identity's updated password. This endpoint\nbehaves differently for API and browser flows.\n\nAPI-initiated flows expect `application/json` to be sent in the body and respond with\nHTTP 200 and an application/json body with the session token on success;\nHTTP 303 redirect to a fresh settings flow if the original flow expired with the appropriate error messages set;\nHTTP 400 on form validation errors.\nHTTP 401 when the endpoint is called without a valid session token.\nHTTP 403 when `selfservice.flows.settings.privileged_session_max_age` was reached or the session's AAL is too low.\nImplies that the user needs to re-authenticate.\n\nBrowser flows without HTTP Header `Accept` or with `Accept: text/*` respond with\na HTTP 303 redirect to the post/after settings URL or the `return_to` value if it was set and if the flow succeeded;\na HTTP 303 redirect to the Settings UI URL with the flow ID containing the validation errors otherwise.\na HTTP 303 redirect to the login endpoint when `selfservice.flows.settings.privileged_session_max_age` was reached or the session's AAL is too low.\n\nBrowser flows with HTTP Header `Accept: application/json` respond with\nHTTP 200 and a application/json body with the signed in identity and a `Set-Cookie` header on success;\nHTTP 303 redirect to a fresh login flow if the original flow expired with the appropriate error messages set;\nHTTP 401 when the endpoint is called without a valid session cookie.\nHTTP 403 when the page is accessed without a session cookie or the session's AAL is too low.\nHTTP 400 on form validation errors.\n\nDepending on your configuration this endpoint might return a 403 error if the session has a lower Authenticator\nAssurance Level (AAL) than is possible for the identity. This can happen if the identity has password + webauthn\ncredentials (which would result in AAL2) but the session has only AAL1. If this error occurs, ask the user\nto sign in with the second factor (happens automatically for server-side browser flows) or change the configuration.\n\nIf this endpoint is called with a `Accept: application/json` HTTP header, the response contains the flow without a redirect. In the\ncase of an error, the `error.id` of the JSON response body can be one of:\n\n`session_refresh_required`: The identity requested to change something that needs a privileged session. Redirect\nthe identity to the login init endpoint with query parameters `?refresh=true\u0026return_to=\u003cthe-current-browser-url\u003e`,\nor initiate a refresh login flow otherwise.\n`security_csrf_violation`: Unable to fetch the flow because a CSRF violation occurred.\n`session_inactive`: No Ory Session was found - sign in a user first.\n`security_identity_mismatch`: The flow was interrupted with `session_refresh_required` but apparently some other\nidentity logged in instead.\n`security_identity_mismatch`: The requested `?return_to` address is not allowed to be used. Adjust this in the configuration!\n`browser_location_change_required`: Usually sent when an AJAX request indicates that the browser needs to open a specific URL.\nMost likely used in Social Sign In flows.\n\nMore information can be found at [Ory Kratos User Settings \u0026 Profile Management Documentation](../self-service/flows/user-settings).", "operationId": "updateSettingsFlow", "parameters": [ { "description": "The Settings Flow ID\n\nThe value for this parameter comes from `flow` URL Query parameter sent to your\napplication (e.g. `/settings?flow=abcde`).", "in": "query", "name": "flow", "required": true, "schema": { "type": "string" } }, { "description": "The Session Token of the Identity performing the settings flow.", "in": "header", "name": "X-Session-Token", "schema": { "type": "string" } }, { "description": "HTTP Cookies\n\nWhen using the SDK in a browser app, on the server side you must include the HTTP Cookie Header\nsent by the client to your server here. This ensures that CSRF and session cookies are respected.", "in": "header", "name": "Cookie", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/updateSettingsFlowBody" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/updateSettingsFlowBody" } } }, "required": true, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/settingsFlow" } } }, "description": "settingsFlow" }, "303": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/settingsFlow" } } }, "description": "settingsFlow" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorBrowserLocationChangeRequired" } } }, "description": "errorBrowserLocationChangeRequired" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "sessionToken": [] } ], "summary": "Complete Settings Flow", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-low" } }, "/self-service/settings/api": { "get": { "description": "This endpoint initiates a settings flow for API clients such as mobile devices, smart TVs, and so on.\nYou must provide a valid Ory Kratos Session Token for this endpoint to respond with HTTP 200 OK.\n\nTo fetch an existing settings flow call `/self-service/settings/flows?flow=\u003cflow_id\u003e`.\n\nYou MUST NOT use this endpoint in client-side (Single Page Apps, ReactJS, AngularJS) nor server-side (Java Server\nPages, NodeJS, PHP, Golang, ...) browser applications. Using this endpoint in these applications will make\nyou vulnerable to a variety of CSRF attacks.\n\nDepending on your configuration this endpoint might return a 403 error if the session has a lower Authenticator\nAssurance Level (AAL) than is possible for the identity. This can happen if the identity has password + webauthn\ncredentials (which would result in AAL2) but the session has only AAL1. If this error occurs, ask the user\nto sign in with the second factor or change the configuration.\n\nIn the case of an error, the `error.id` of the JSON response body can be one of:\n\n`security_csrf_violation`: Unable to fetch the flow because a CSRF violation occurred.\n`session_inactive`: No Ory Session was found - sign in a user first.\n\nThis endpoint MUST ONLY be used in scenarios such as native mobile apps (React Native, Objective C, Swift, Java, ...).\n\nMore information can be found at [Ory Kratos User Settings \u0026 Profile Management Documentation](../self-service/flows/user-settings).", "operationId": "createNativeSettingsFlow", "parameters": [ { "description": "The Session Token of the Identity performing the settings flow.", "in": "header", "name": "X-Session-Token", "schema": { "type": "string" } }, { "description": "An optional organization ID that scopes the settings flow to providers of that organization.\nThis parameter is only effective in the Ory Network.", "in": "query", "name": "organization", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/settingsFlow" } } }, "description": "settingsFlow" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Create Settings Flow for Native Apps", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-medium" } }, "/self-service/settings/browser": { "get": { "description": "This endpoint initializes a browser-based user settings flow. Once initialized, the browser will be redirected to\n`selfservice.flows.settings.ui_url` with the flow ID set as the query parameter `?flow=`. If no valid\nOry Kratos Session Cookie is included in the request, a login flow will be initialized.\n\nIf this endpoint is opened as a link in the browser, it will be redirected to\n`selfservice.flows.settings.ui_url` with the flow ID set as the query parameter `?flow=`. If no valid user session\nwas set, the browser will be redirected to the login endpoint.\n\nIf this endpoint is called via an AJAX request, the response contains the settings flow without any redirects\nor a 401 forbidden error if no valid session was set.\n\nDepending on your configuration this endpoint might return a 403 error if the session has a lower Authenticator\nAssurance Level (AAL) than is possible for the identity. This can happen if the identity has password + webauthn\ncredentials (which would result in AAL2) but the session has only AAL1. If this error occurs, ask the user\nto sign in with the second factor (happens automatically for server-side browser flows) or change the configuration.\n\nIf this endpoint is called via an AJAX request, the response contains the flow without a redirect. In the\ncase of an error, the `error.id` of the JSON response body can be one of:\n\n`security_csrf_violation`: Unable to fetch the flow because a CSRF violation occurred.\n`session_inactive`: No Ory Session was found - sign in a user first.\n`security_identity_mismatch`: The requested `?return_to` address is not allowed to be used. Adjust this in the configuration!\n\nThis endpoint is NOT INTENDED for clients that do not have a browser (Chrome, Firefox, ...) as cookies are needed.\n\nMore information can be found at [Ory Kratos User Settings \u0026 Profile Management Documentation](../self-service/flows/user-settings).", "operationId": "createBrowserSettingsFlow", "parameters": [ { "description": "The URL to return the browser to after the flow was completed.", "in": "query", "name": "return_to", "schema": { "type": "string" } }, { "description": "HTTP Cookies\n\nWhen using the SDK in a browser app, on the server side you must include the HTTP Cookie Header\nsent by the client to your server here. This ensures that CSRF and session cookies are respected.", "in": "header", "name": "Cookie", "schema": { "type": "string" } }, { "description": "An optional organization ID that scopes the settings flow to providers of that organization.\nThis parameter is only effective in the Ory Network.", "in": "query", "name": "organization", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/settingsFlow" } } }, "description": "settingsFlow" }, "303": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Create Settings Flow for Browsers", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-medium" } }, "/self-service/settings/flows": { "get": { "description": "When accessing this endpoint through Ory Kratos' Public API you must ensure that either the Ory Kratos Session Cookie\nor the Ory Kratos Session Token are set.\n\nDepending on your configuration this endpoint might return a 403 error if the session has a lower Authenticator\nAssurance Level (AAL) than is possible for the identity. This can happen if the identity has password + webauthn\ncredentials (which would result in AAL2) but the session has only AAL1. If this error occurs, ask the user\nto sign in with the second factor or change the configuration.\n\nYou can access this endpoint without credentials when using Ory Kratos' Admin API.\n\nIf this endpoint is called via an AJAX request, the response contains the flow without a redirect. In the\ncase of an error, the `error.id` of the JSON response body can be one of:\n\n`security_csrf_violation`: Unable to fetch the flow because a CSRF violation occurred.\n`session_inactive`: No Ory Session was found - sign in a user first.\n`security_identity_mismatch`: The flow was interrupted with `session_refresh_required` but apparently some other\nidentity logged in instead.\n\nMore information can be found at [Ory Kratos User Settings \u0026 Profile Management Documentation](../self-service/flows/user-settings).", "operationId": "getSettingsFlow", "parameters": [ { "description": "ID is the Settings Flow ID\n\nThe value for this parameter comes from `flow` URL Query parameter sent to your\napplication (e.g. `/settings?flow=abcde`).", "in": "query", "name": "id", "required": true, "schema": { "type": "string" } }, { "description": "The Session Token\n\nWhen using the SDK in an app without a browser, please include the\nsession token here.", "in": "header", "name": "X-Session-Token", "schema": { "type": "string" } }, { "description": "HTTP Cookies\n\nWhen using the SDK in a browser app, on the server side you must include the HTTP Cookie Header\nsent by the client to your server here. This ensures that CSRF and session cookies are respected.", "in": "header", "name": "Cookie", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/settingsFlow" } } }, "description": "settingsFlow" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Get Settings Flow", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-high" } }, "/self-service/verification": { "post": { "description": "Use this endpoint to complete a verification flow. This endpoint\nbehaves differently for API and browser flows and has several states:\n\n`choose_method` expects `flow` (in the URL query) and `email` (in the body) to be sent\nand works with API- and Browser-initiated flows.\nFor API clients and Browser clients with HTTP Header `Accept: application/json` it either returns a HTTP 200 OK when the form is valid and HTTP 400 OK when the form is invalid\nand a HTTP 303 See Other redirect with a fresh verification flow if the flow was otherwise invalid (e.g. expired).\nFor Browser clients without HTTP Header `Accept` or with `Accept: text/*` it returns a HTTP 303 See Other redirect to the Verification UI URL with the Verification Flow ID appended.\n`sent_email` is the success state after `choose_method` when using the `link` method and allows the user to request another verification email. It\nworks for both API and Browser-initiated flows and returns the same responses as the flow in `choose_method` state.\n`passed_challenge` expects a `token` to be sent in the URL query and given the nature of the flow (\"sending a verification link\")\ndoes not have any API capabilities. The server responds with a HTTP 303 See Other redirect either to the Settings UI URL\n(if the link was valid) and instructs the user to update their password, or a redirect to the Verification UI URL with\na new Verification Flow ID which contains an error message that the verification link was invalid.\n\nMore information can be found at [Ory Kratos Email and Phone Verification Documentation](https://www.ory.com/docs/kratos/self-service/flows/verify-email-account-activation).", "operationId": "updateVerificationFlow", "parameters": [ { "description": "The Verification Flow ID\n\nThe value for this parameter comes from `flow` URL Query parameter sent to your\napplication (e.g. `/verification?flow=abcde`).", "in": "query", "name": "flow", "required": true, "schema": { "type": "string" } }, { "description": "Verification Token\n\nThe verification token which completes the verification request. If the token\nis invalid (e.g. expired) an error will be shown to the end-user.\n\nThis parameter is usually set in a link and not used by any direct API call.", "in": "query", "name": "token", "schema": { "type": "string" } }, { "description": "HTTP Cookies\n\nWhen using the SDK in a browser app, on the server side you must include the HTTP Cookie Header\nsent by the client to your server here. This ensures that CSRF and session cookies are respected.", "in": "header", "name": "Cookie", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/updateVerificationFlowBody" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/updateVerificationFlowBody" } } }, "required": true, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/verificationFlow" } } }, "description": "verificationFlow" }, "303": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/verificationFlow" } } }, "description": "verificationFlow" }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Complete Verification Flow", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-low" } }, "/self-service/verification/api": { "get": { "description": "This endpoint initiates a verification flow for API clients such as mobile devices, smart TVs, and so on.\n\nTo fetch an existing verification flow call `/self-service/verification/flows?flow=\u003cflow_id\u003e`.\n\nYou MUST NOT use this endpoint in client-side (Single Page Apps, ReactJS, AngularJS) nor server-side (Java Server\nPages, NodeJS, PHP, Golang, ...) browser applications. Using this endpoint in these applications will make\nyou vulnerable to a variety of CSRF attacks.\n\nThis endpoint MUST ONLY be used in scenarios such as native mobile apps (React Native, Objective C, Swift, Java, ...).\n\nMore information can be found at [Ory Email and Phone Verification Documentation](https://www.ory.com/docs/kratos/self-service/flows/verify-email-account-activation).", "operationId": "createNativeVerificationFlow", "parameters": [ { "description": "A URL contained in the return_to key of the verification flow.\nThis piece of data has no effect on the actual logic of the flow and is purely informational.", "in": "query", "name": "return_to", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/verificationFlow" } } }, "description": "verificationFlow" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Create Verification Flow for Native Apps", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-medium" } }, "/self-service/verification/browser": { "get": { "description": "This endpoint initializes a browser-based account verification flow. Once initialized, the browser will be redirected to\n`selfservice.flows.verification.ui_url` with the flow ID set as the query parameter `?flow=`.\n\nIf this endpoint is called via an AJAX request, the response contains the recovery flow without any redirects.\n\nThis endpoint is NOT INTENDED for API clients and only works with browsers (Chrome, Firefox, ...).\n\nMore information can be found at [Ory Kratos Email and Phone Verification Documentation](https://www.ory.com/docs/kratos/self-service/flows/verify-email-account-activation).", "operationId": "createBrowserVerificationFlow", "parameters": [ { "description": "The URL to return the browser to after the flow was completed.", "in": "query", "name": "return_to", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/verificationFlow" } } }, "description": "verificationFlow" }, "303": { "$ref": "#/components/responses/emptyResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Create Verification Flow for Browser Clients", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-medium" } }, "/self-service/verification/flows": { "get": { "description": "This endpoint returns a verification flow's context with, for example, error details and other information.\n\nBrowser flows expect the anti-CSRF cookie to be included in the request's HTTP Cookie Header.\nFor AJAX requests you must ensure that cookies are included in the request or requests will fail.\n\nIf you use the browser-flow for server-side apps, the services need to run on a common top-level-domain\nand you need to forward the incoming HTTP Cookie header to this endpoint:\n\n```js\npseudo-code example\nrouter.get('/recovery', async function (req, res) {\nconst flow = await client.getVerificationFlow(req.header('cookie'), req.query['flow'])\n\nres.render('verification', flow)\n})\n```\n\nMore information can be found at [Ory Kratos Email and Phone Verification Documentation](https://www.ory.com/docs/kratos/self-service/flows/verify-email-account-activation).", "operationId": "getVerificationFlow", "parameters": [ { "description": "The Flow ID\n\nThe value for this parameter comes from `request` URL Query parameter sent to your\napplication (e.g. `/verification?flow=abcde`).", "in": "query", "name": "id", "required": true, "schema": { "type": "string" } }, { "description": "HTTP Cookies\n\nWhen using the SDK on the server side you must include the HTTP Cookie Header\noriginally sent to your HTTP handler here.", "in": "header", "name": "cookie", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/verificationFlow" } } }, "description": "verificationFlow" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Get Verification Flow", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-high" } }, "/sessions": { "delete": { "description": "Calling this endpoint invalidates all except the current session that belong to the logged-in user.\nSession data are not deleted.", "operationId": "disableMyOtherSessions", "parameters": [ { "description": "Set the Session Token when calling from non-browser clients. A session token has a format of `MP2YWEMeM8MxjkGKpH4dqOQ4Q4DlSPaj`.", "in": "header", "name": "X-Session-Token", "schema": { "type": "string" } }, { "description": "Set the Cookie Header. This is especially useful when calling this endpoint from a server-side application. In that\nscenario you must include the HTTP Cookie Header which originally was included in the request to your server.\nAn example of a session in the HTTP Cookie Header is: `ory_kratos_session=a19iOVAbdzdgl70Rq1QZmrKmcjDtdsviCTZx7m9a9yHIUS8Wa9T7hvqyGTsLHi6Qifn2WUfpAKx9DWp0SJGleIn9vh2YF4A16id93kXFTgIgmwIOvbVAScyrx7yVl6bPZnCx27ec4WQDtaTewC1CpgudeDV2jQQnSaCP6ny3xa8qLH-QUgYqdQuoA_LF1phxgRCUfIrCLQOkolX5nv3ze_f==`.\n\nIt is ok if more than one cookie are included here as all other cookies will be ignored.", "in": "header", "name": "Cookie", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/deleteMySessionsCount" } } }, "description": "deleteMySessionsCount" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Disable my other sessions", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-low" }, "get": { "description": "This endpoints returns all other active sessions that belong to the logged-in user.\nThe current session can be retrieved by calling the `/sessions/whoami` endpoint.", "operationId": "listMySessions", "parameters": [ { "description": "Deprecated Items per Page\n\nDEPRECATED: Please use `page_token` instead. This parameter will be removed in the future.\n\nThis is the number of items per page.", "in": "query", "name": "per_page", "schema": { "default": 250, "format": "int64", "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "Deprecated Pagination Page\n\nDEPRECATED: Please use `page_token` instead. This parameter will be removed in the future.\n\nThis value is currently an integer, but it is not sequential. The value is not the page number, but a\nreference. The next page can be any number and some numbers might return an empty list.\n\nFor example, page 2 might not follow after page 1. And even if page 3 and 5 exist, but page 4 might not exist.\nThe first page can be retrieved by omitting this parameter. Following page pointers will be returned in the\n`Link` header.", "in": "query", "name": "page", "schema": { "format": "int64", "type": "integer" } }, { "description": "Page Size\n\nThis is the number of items per page to return. For details on pagination please head over to the\n[pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_size", "schema": { "default": 250, "format": "int64", "maximum": 500, "minimum": 1, "type": "integer" } }, { "description": "Next Page Token\n\nThe next page token. For details on pagination please head over to the\n[pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_token", "schema": { "type": "string" } }, { "description": "Set the Session Token when calling from non-browser clients. A session token has a format of `MP2YWEMeM8MxjkGKpH4dqOQ4Q4DlSPaj`.", "in": "header", "name": "X-Session-Token", "schema": { "type": "string" } }, { "description": "Set the Cookie Header. This is especially useful when calling this endpoint from a server-side application. In that\nscenario you must include the HTTP Cookie Header which originally was included in the request to your server.\nAn example of a session in the HTTP Cookie Header is: `ory_kratos_session=a19iOVAbdzdgl70Rq1QZmrKmcjDtdsviCTZx7m9a9yHIUS8Wa9T7hvqyGTsLHi6Qifn2WUfpAKx9DWp0SJGleIn9vh2YF4A16id93kXFTgIgmwIOvbVAScyrx7yVl6bPZnCx27ec4WQDtaTewC1CpgudeDV2jQQnSaCP6ny3xa8qLH-QUgYqdQuoA_LF1phxgRCUfIrCLQOkolX5nv3ze_f==`.\n\nIt is ok if more than one cookie are included here as all other cookies will be ignored.", "in": "header", "name": "Cookie", "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/listMySessions" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Get My Active Sessions", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-medium" } }, "/sessions/token-exchange": { "get": { "operationId": "exchangeSessionToken", "parameters": [ { "description": "The part of the code return when initializing the flow.", "in": "query", "name": "init_code", "required": true, "schema": { "type": "string" } }, { "description": "The part of the code returned by the return_to URL.", "in": "query", "name": "return_to_code", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/successfulNativeLogin" } } }, "description": "successfulNativeLogin" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Exchange Session Token", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-medium" } }, "/sessions/whoami": { "get": { "description": "Uses the HTTP Headers in the GET request to determine (e.g. by using checking the cookies) who is authenticated.\nReturns a session object in the body or 401 if the credentials are invalid or no credentials were sent.\nWhen the request it successful it adds the user ID to the 'X-Kratos-Authenticated-Identity-Id' header\nin the response.\n\nIf you call this endpoint from a server-side application, you must forward the HTTP Cookie Header to this endpoint:\n\n```js\npseudo-code example\nrouter.get('/protected-endpoint', async function (req, res) {\nconst session = await client.toSession(undefined, req.header('cookie'))\n\nconsole.log(session)\n})\n```\n\nWhen calling this endpoint from a non-browser application (e.g. mobile app) you must include the session token:\n\n```js\npseudo-code example\n...\nconst session = await client.toSession(\"the-session-token\")\n\nconsole.log(session)\n```\n\nWhen using a token template, the token is included in the `tokenized` field of the session.\n\n```js\npseudo-code example\n...\nconst session = await client.toSession(\"the-session-token\", { tokenize_as: \"example-jwt-template\" })\n\nconsole.log(session.tokenized) // The JWT\n```\n\nDepending on your configuration this endpoint might return a 403 status code if the session has a lower Authenticator\nAssurance Level (AAL) than is possible for the identity. This can happen if the identity has password + webauthn\ncredentials (which would result in AAL2) but the session has only AAL1. If this error occurs, ask the user\nto sign in with the second factor or change the configuration.\n\nThis endpoint is useful for:\n\nAJAX calls. Remember to send credentials and set up CORS correctly!\nReverse proxies and API Gateways\nServer-side calls - use the `X-Session-Token` header!\n\nThis endpoint authenticates users by checking:\n\nif the `Cookie` HTTP header was set containing an Ory Kratos Session Cookie;\nif the `Authorization: bearer \u003cory-session-token\u003e` HTTP header was set with a valid Ory Kratos Session Token;\nif the `X-Session-Token` HTTP header was set with a valid Ory Kratos Session Token.\n\nIf none of these headers are set or the cookie or token are invalid, the endpoint returns a HTTP 401 status code.\n\nAs explained above, this request may fail due to several reasons. The `error.id` can be one of:\n\n`session_inactive`: No active session was found in the request (e.g. no Ory Session Cookie / Ory Session Token).\n`session_aal2_required`: An active session was found but it does not fulfil the Authenticator Assurance Level, implying that the session must (e.g.) authenticate the second factor.", "operationId": "toSession", "parameters": [ { "description": "Set the Session Token when calling from non-browser clients. A session token has a format of `MP2YWEMeM8MxjkGKpH4dqOQ4Q4DlSPaj`.", "example": "MP2YWEMeM8MxjkGKpH4dqOQ4Q4DlSPaj", "in": "header", "name": "X-Session-Token", "schema": { "type": "string" } }, { "description": "Set the Cookie Header. This is especially useful when calling this endpoint from a server-side application. In that\nscenario you must include the HTTP Cookie Header which originally was included in the request to your server.\nAn example of a session in the HTTP Cookie Header is: `ory_kratos_session=a19iOVAbdzdgl70Rq1QZmrKmcjDtdsviCTZx7m9a9yHIUS8Wa9T7hvqyGTsLHi6Qifn2WUfpAKx9DWp0SJGleIn9vh2YF4A16id93kXFTgIgmwIOvbVAScyrx7yVl6bPZnCx27ec4WQDtaTewC1CpgudeDV2jQQnSaCP6ny3xa8qLH-QUgYqdQuoA_LF1phxgRCUfIrCLQOkolX5nv3ze_f==`.\n\nIt is ok if more than one cookie are included here as all other cookies will be ignored.", "example": "ory_session=a19iOVAbdzdgl70Rq1QZmrKmcjDtdsviCTZx7m9a9yHIUS8Wa9T7hvqyGTsLHi6Qifn2WUfpAKx9DWp0SJGleIn9vh2YF4A16id93kXFTgIgmwIOvbVAScyrx7yVl6bPZnCx27ec4WQDtaTewC1CpgudeDV2jQQnSaCP6ny3xa8qLH-QUgYqdQuoA_LF1phxgRCUfIrCLQOkolX5nv3ze_f==", "in": "header", "name": "Cookie", "schema": { "type": "string" } }, { "description": "Returns the session additionally as a token (such as a JWT)\n\nThe value of this parameter has to be a valid, configured Ory Session token template. For more information head over to [the documentation](http://ory.sh/docs/identities/session-to-jwt-cors).", "in": "query", "name": "tokenize_as", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/session" } } }, "description": "session" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Check Who the Current HTTP Session Belongs To", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-high" } }, "/sessions/{id}": { "delete": { "description": "Calling this endpoint invalidates the specified session. The current session cannot be revoked.\nSession data are not deleted.", "operationId": "disableMySession", "parameters": [ { "description": "ID is the session's ID.", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "description": "Set the Session Token when calling from non-browser clients. A session token has a format of `MP2YWEMeM8MxjkGKpH4dqOQ4Q4DlSPaj`.", "in": "header", "name": "X-Session-Token", "schema": { "type": "string" } }, { "description": "Set the Cookie Header. This is especially useful when calling this endpoint from a server-side application. In that\nscenario you must include the HTTP Cookie Header which originally was included in the request to your server.\nAn example of a session in the HTTP Cookie Header is: `ory_kratos_session=a19iOVAbdzdgl70Rq1QZmrKmcjDtdsviCTZx7m9a9yHIUS8Wa9T7hvqyGTsLHi6Qifn2WUfpAKx9DWp0SJGleIn9vh2YF4A16id93kXFTgIgmwIOvbVAScyrx7yVl6bPZnCx27ec4WQDtaTewC1CpgudeDV2jQQnSaCP6ny3xa8qLH-QUgYqdQuoA_LF1phxgRCUfIrCLQOkolX5nv3ze_f==`.\n\nIt is ok if more than one cookie are included here as all other cookies will be ignored.", "in": "header", "name": "Cookie", "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "summary": "Disable one of my sessions", "tags": [ "frontend" ], "x-ory-ratelimit-bucket": "kratos-public-low" } }, "/userinfo": { "get": { "description": "This endpoint returns the payload of the ID Token, including `session.id_token` values, of\nthe provided OAuth 2.0 Access Token's consent request.\n\nIn the case of authentication error, a WWW-Authenticate header might be set in the response\nwith more information about the error. See [the spec](https://datatracker.ietf.org/doc/html/rfc6750#section-3)\nfor more details about header format.", "operationId": "getOidcUserInfo", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oidcUserInfo" } } }, "description": "oidcUserInfo" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorOAuth2" } } }, "description": "errorOAuth2" } }, "security": [ { "oauth2": [] } ], "summary": "OpenID Connect Userinfo", "tags": [ "oidc" ], "x-ory-ratelimit-bucket": "hydra-public-medium" } }, "/v2alpha1/admin/apiKeys:batchVerify": { "post": { "description": "Verifies multiple credentials in a single request. Efficiently verifies up\nto 100 credentials in parallel. Each credential is verified independently;\npartial failures are returned. Admin access only.\n\nCache Control (HTTP Headers):\n - Cache-Control: no-cache - Bypasses cache read, forces fresh DB lookup\n - Cache-Control: no-store - Bypasses cache read AND write (never cached)\n - Pragma: no-cache - Same as Cache-Control: no-cache (HTTP/1.0)\n\nThe cache directive applies to every credential in the batch.\n\n```http\nPOST /v2alpha1/admin/apiKeys:batchVerify\n{\n \"requests\": [\n {\"credential\": \"sk_live_abc123...\"},\n {\"credential\": \"eyJhbGciOiJFZERTQSI...\"}\n ]\n}\n```", "operationId": "adminBatchVerifyApiKeys", "parameters": [ { "description": "Cache-directive controlling the verifier cache. `no-cache` forces a fresh database lookup (cache read is bypassed). `no-store` additionally prevents the result from being written to the cache. Any other value is ignored.", "in": "header", "name": "Cache-Control", "schema": { "type": "string" } }, { "description": "HTTP/1.0 alias for `Cache-Control: no-cache`. Behaves identically when set to `no-cache`; ignored otherwise.", "in": "header", "name": "Pragma", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BatchVerifyApiKeysRequest" } } }, "required": true, "x-originalParamName": "body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BatchVerifyApiKeysResponse" } } }, "description": "A successful response." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "An unexpected error response." } }, "security": [ { "oryAccessToken": [] } ], "summary": "Batch Verify API Keys", "tags": [ "ApiKeys" ] } }, "/v2alpha1/admin/apiKeys:derive": { "post": { "description": "Mints a short-lived JWT or Macaroon token from an API key. Works with both\nissued and imported keys. The derived token inherits the permissions of the\nparent API key.\n\n```http\nPOST /v2alpha1/admin/apiKeys:derive\n{\n \"credential\": \"eyJhbGciOiJFZERTQSI...\",\n \"ttl\": \"1h\"\n}\n```", "operationId": "adminDeriveToken", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeriveTokenRequest" } } }, "required": true, "x-originalParamName": "body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeriveTokenResponse" } } }, "description": "A successful response." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "An unexpected error response." } }, "security": [ { "oryAccessToken": [] } ], "summary": "Derive Token", "tags": [ "ApiKeys" ] } }, "/v2alpha1/admin/apiKeys:verify": { "post": { "description": "Verifies a single API key or derived token. Validates the credential's\nsignature, expiration, and revocation status. Works with any credential\ntype (issued keys, imported keys, JWT, macaroon). The verification result\nincludes decoded claims and metadata — admin access only.\n\nCache Control (HTTP Headers):\n - Cache-Control: no-cache - Bypasses cache read, forces fresh DB lookup\n - Cache-Control: no-store - Bypasses cache read AND write (never cached)\n - Pragma: no-cache - Same as Cache-Control: no-cache (HTTP/1.0)\n\n```http\nPOST /v2alpha1/admin/apiKeys:verify\n{\n \"credential\": \"sk_live_abc123...\"\n}\n```", "operationId": "adminVerifyApiKey", "parameters": [ { "description": "Cache-directive controlling the verifier cache. `no-cache` forces a fresh database lookup (cache read is bypassed). `no-store` additionally prevents the result from being written to the cache. Any other value is ignored.", "in": "header", "name": "Cache-Control", "schema": { "type": "string" } }, { "description": "HTTP/1.0 alias for `Cache-Control: no-cache`. Behaves identically when set to `no-cache`; ignored otherwise.", "in": "header", "name": "Pragma", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VerifyApiKeyRequest" } } }, "required": true, "x-originalParamName": "body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VerifyApiKeyResponse" } } }, "description": "A successful response." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "An unexpected error response." } }, "security": [ { "oryAccessToken": [] } ], "summary": "Verify API Key", "tags": [ "ApiKeys" ] } }, "/v2alpha1/admin/importedApiKeys": { "get": { "description": "Lists all imported keys with filtering. Returns imported keys only (not\nissued keys). Supports pagination and AIP-160 filter expressions.\n\n```http\nGET /v2alpha1/admin/importedApiKeys?page_size=50\u0026filter=status%3DKEY_STATUS_ACTIVE\n```", "operationId": "adminListImportedApiKeys", "parameters": [ { "description": "Number of items per page (default: 50, max: 1000)", "in": "query", "name": "page_size", "schema": { "format": "int32", "type": "integer" } }, { "description": "Cursor token for pagination (OPTIONAL)", "in": "query", "name": "page_token", "schema": { "type": "string" } }, { "description": "filter is an AIP-160 expression. Indexed fields (efficient at any scale):\n actor_id, status. Other fields are not indexed and may be rejected.\nExamples:\n actor_id=\"user_123\"\n status=KEY_STATUS_ACTIVE\n actor_id=\"user_123\" AND status=KEY_STATUS_ACTIVE", "in": "query", "name": "filter", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListImportedApiKeysResponse" } } }, "description": "A successful response." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "An unexpected error response." } }, "security": [ { "oryAccessToken": [] } ], "summary": "List Imported API Keys", "tags": [ "ApiKeys" ] }, "post": { "description": "Imports an external API key into the system. Allows importing keys from\nlegacy systems or external providers. The raw key is hashed and stored\nsecurely (HMAC). Imported keys support token derivation (JWT/Macaroon)\nlike issued keys.\n\n```http\nPOST /v2alpha1/admin/importedApiKeys\n{\n \"raw_key\": \"imported-key-EXAMPLE-not-a-real-secret\",\n \"name\": \"Example imported key\",\n \"actor_id\": \"user_123\"\n}\n```", "operationId": "adminImportApiKey", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportApiKeyRequest" } } }, "description": "Example:\n {\n \"raw_key\": \"imported-key-EXAMPLE-not-a-real-secret\",\n \"name\": \"Example imported key\",\n \"actor_id\": \"payment-processor\",\n \"scopes\": [\"read\", \"write\"],\n \"ttl\": \"8760h\", // 1 year (also accepts: 31536000s)\n \"metadata\": {\"source\": \"example-provider\", \"environment\": \"staging\"}\n }", "required": true, "x-originalParamName": "body" }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportedApiKey" } } }, "description": "API key imported successfully." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "An unexpected error response." } }, "security": [ { "oryAccessToken": [] } ], "summary": "Import API Key", "tags": [ "ApiKeys" ] } }, "/v2alpha1/admin/importedApiKeys/{key_id}": { "delete": { "description": "Permanently deletes an imported key (hard delete). The key is removed from\nthe database. Use AdminRevokeImportedApiKey for soft deletion (recommended).\n\n```http\nDELETE /v2alpha1/admin/importedApiKeys/{key_id}\n```", "operationId": "adminDeleteImportedApiKey", "parameters": [ { "description": "SHA512/256 hash of the imported key (REQUIRED)", "in": "path", "name": "key_id", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "Imported key deleted successfully." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "An unexpected error response." } }, "security": [ { "oryAccessToken": [] } ], "summary": "Delete Imported API Key", "tags": [ "ApiKeys" ] }, "get": { "description": "Retrieves details about a specific imported key. Returns metadata about\nthe imported key. The original raw key is never returned.\n\n```http\nGET /v2alpha1/admin/importedApiKeys/{key_id}\n```", "operationId": "adminGetImportedApiKey", "parameters": [ { "description": "SHA512/256 hash of the imported key (REQUIRED)", "in": "path", "name": "key_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportedApiKey" } } }, "description": "A successful response." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "An unexpected error response." } }, "security": [ { "oryAccessToken": [] } ], "summary": "Get Imported API Key", "tags": [ "ApiKeys" ] }, "patch": { "description": "Updates metadata, scopes, or rate limits of an imported key. Supports\npartial updates via the update_mask query parameter (AIP-134). Omitting\nupdate_mask is equivalent to a mask of every populated field in the body.\nTo clear a field to its zero value, list it explicitly in update_mask and\nleave it unset (or empty) in the body.\n\n```http\nPATCH /v2alpha1/admin/importedApiKeys/{key_id}?update_mask=name\n{\n \"imported_api_key\": {\n \"key_id\": \"{key_id}\",\n \"name\": \"New name\"\n }\n}\n```", "operationId": "adminUpdateImportedApiKey", "parameters": [ { "description": "SHA-512/256 hash of credential", "in": "path", "name": "key_id", "required": true, "schema": { "type": "string" } }, { "description": "The list of fields to update. See AIP-134.", "in": "query", "name": "update_mask", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "description": "ImportedApiKey represents an API key imported from an external system.\nThe raw key is hashed (SHA-512/256) and stored. The original key is never retained.", "properties": { "actor_id": { "type": "string" }, "create_time": { "format": "date-time", "type": "string" }, "expire_time": { "format": "date-time", "type": "string" }, "ip_restriction": { "$ref": "#/components/schemas/IPRestriction" }, "last_used_time": { "format": "date-time", "type": "string" }, "metadata": { "description": "metadata is a free-form JSON object for caller-defined attributes\n(e.g., source, environment, tags). Values may be strings, numbers,\nbooleans, arrays, objects, or null. Total serialized size is capped\nat 4KB. AIP-148 metadata field.", "type": "object" }, "name": { "type": "string" }, "rate_limit_policy": { "$ref": "#/components/schemas/RateLimitPolicy" }, "revocation_description": { "description": "revocation_description provides free-form context for a revocation.\nOnly set when revocation_reason is PRIVILEGE_WITHDRAWN.\nJSON API change: field was formerly revocation_reason_text. Field number 13\nis unchanged so the change is wire-compatible for binary proto encoding.", "type": "string" }, "revocation_reason": { "$ref": "#/components/schemas/RevocationReason" }, "scopes": { "items": { "type": "string" }, "type": "array" }, "status": { "$ref": "#/components/schemas/KeyStatus" }, "update_time": { "format": "date-time", "type": "string" }, "visibility": { "$ref": "#/components/schemas/KeyVisibility" } }, "type": "object" } } }, "required": true, "x-originalParamName": "imported_api_key" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportedApiKey" } } }, "description": "A successful response." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "An unexpected error response." } }, "security": [ { "oryAccessToken": [] } ], "summary": "Update Imported API Key", "tags": [ "ApiKeys" ] } }, "/v2alpha1/admin/importedApiKeys/{key_id}:revoke": { "post": { "description": "Immediately revokes an imported API key. Once revoked, the key can no longer\nbe used for authentication. This operation is irreversible. Revoked keys\nare retained for audit purposes.\n\n```http\nPOST /v2alpha1/admin/importedApiKeys/9a3f051b2c7e8d4f1a6b9c0e5f2d8a3b:revoke\n{\n \"reason\": \"REVOCATION_REASON_KEY_COMPROMISE\"\n}\n```", "operationId": "adminRevokeImportedApiKey", "parameters": [ { "description": "SHA-512/256 hash of the imported key (REQUIRED)", "in": "path", "name": "key_id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevokeImportedApiKeyBody" } } }, "required": true, "x-originalParamName": "body" }, "responses": { "204": { "description": "API key revoked successfully." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "An unexpected error response." } }, "security": [ { "oryAccessToken": [] } ], "summary": "Revoke Imported API Key", "tags": [ "ApiKeys" ] } }, "/v2alpha1/admin/importedApiKeys:batchCreate": { "post": { "description": "Imports up to 1000 external API keys in one request. Returns per-item\nresults. If at least one item succeeds, response is 200 OK. If all items\nfail, the endpoint returns a non-200 error.\n\n```http\nPOST /v2alpha1/admin/importedApiKeys:batchCreate\n{\n \"requests\": [\n {\"raw_key\": \"sk_live_abc\", \"name\": \"Stripe key\", \"actor_id\": \"user_1\"},\n {\"raw_key\": \"ghp_xyz\", \"name\": \"GitHub PAT\", \"actor_id\": \"user_2\"}\n ]\n}\n```", "operationId": "adminBatchCreateImportedApiKeys", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BatchCreateImportedApiKeysRequest" } } }, "description": "BatchCreateImportedApiKeysRequest imports multiple external API keys in one request.\nThe maximum batch size is 1000 keys.", "required": true, "x-originalParamName": "body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BatchCreateImportedApiKeysResponse" } } }, "description": "Batch import completed. Check per-item results for individual status." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "An unexpected error response." } }, "security": [ { "oryAccessToken": [] } ], "summary": "Batch Import API Keys", "tags": [ "ApiKeys" ] } }, "/v2alpha1/admin/issuedApiKeys": { "get": { "description": "Lists issued API keys with optional filtering. Supports cursor-based\npagination and AIP-160 filter expressions. Returns only issued\n(generated) API keys; use ListImportedApiKeys for imported keys.\n\n```http\nGET /v2alpha1/admin/issuedApiKeys?page_size=50\u0026filter=actor_id%3D%22user_123%22\n```", "operationId": "adminListIssuedApiKeys", "parameters": [ { "description": "Number of items per page (default: 50, max: 1000)", "in": "query", "name": "page_size", "schema": { "format": "int32", "type": "integer" } }, { "description": "Cursor token for pagination", "in": "query", "name": "page_token", "schema": { "type": "string" } }, { "description": "filter is an AIP-160 expression. Indexed fields (efficient at any scale):\n actor_id, status. Other fields are not indexed and may be rejected.\nExamples:\n actor_id=\"user_123\"\n status=KEY_STATUS_ACTIVE\n actor_id=\"user_123\" AND status=KEY_STATUS_ACTIVE", "in": "query", "name": "filter", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListIssuedApiKeysResponse" } } }, "description": "A successful response." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "An unexpected error response." } }, "security": [ { "oryAccessToken": [] } ], "summary": "List Issued API Keys", "tags": [ "ApiKeys" ] }, "post": { "description": "Creates a new API key for a given actor. The secret is returned only once\nin the response and cannot be retrieved later. Keys can be scoped with\nspecific permissions and have optional expiration.\n\n```http\nPOST /v2alpha1/admin/issuedApiKeys\n{\n \"name\": \"production-service\",\n \"actor_id\": \"user_123\",\n \"scopes\": [\"read\", \"write\"],\n \"ttl\": \"8760h\"\n}\n```", "operationId": "adminIssueApiKey", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IssueApiKeyRequest" } } }, "required": true, "x-originalParamName": "body" }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IssueApiKeyResponse" } } }, "description": "API key issued successfully." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "An unexpected error response." } }, "security": [ { "oryAccessToken": [] } ], "summary": "Issue API Key", "tags": [ "ApiKeys" ] } }, "/v2alpha1/admin/issuedApiKeys/{key_id}": { "get": { "description": "Retrieves details about a specific issued API key including its status,\nscopes, expiration, and usage statistics. The secret is never returned.\n\n```http\nGET /v2alpha1/admin/issuedApiKeys/01HQZX9VYQKJB8XQZQXQZQXQXQ\n```", "operationId": "adminGetIssuedApiKey", "parameters": [ { "description": "Identifier of the API key resource.", "in": "path", "name": "key_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IssuedApiKey" } } }, "description": "A successful response." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "An unexpected error response." } }, "security": [ { "oryAccessToken": [] } ], "summary": "Get Issued API Key", "tags": [ "ApiKeys" ] }, "patch": { "description": "Updates metadata, scopes, or rate limits of an issued key without rotating\nthe secret. Use RotateIssuedApiKey to change the secret.\n\nFollows AIP-134: the request body is the IssuedApiKey resource itself,\nand the update_mask query parameter names the subset of fields to apply.\nOmitting update_mask is equivalent to a mask of every populated field\nin the body. To clear a field to its zero value, list it explicitly in\nupdate_mask and leave it unset (or empty) in the body.\n\n```http\nPATCH /v2alpha1/admin/issuedApiKeys/01HQZX9VYQKJB8XQZQXQZQXQXQ?update_mask=scopes\n{\n \"issued_api_key\": {\n \"key_id\": \"01HQZX9VYQKJB8XQZQXQZQXQXQ\",\n \"scopes\": [\"read\"]\n }\n}\n```", "operationId": "adminUpdateIssuedApiKey", "parameters": [ { "description": "Identifier of the API key resource.", "in": "path", "name": "key_id", "required": true, "schema": { "type": "string" } }, { "description": "The list of fields to update. See AIP-134.", "in": "query", "name": "update_mask", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "description": "IssuedApiKey represents an API key issued (generated) by Talos.\nRoot keys are opaque v1 format tokens stored in the database.\nDerived tokens (JWT/Macaroon) are created via DeriveToken and are stateless (not stored).", "properties": { "actor_id": { "type": "string" }, "create_time": { "format": "date-time", "type": "string" }, "expire_time": { "format": "date-time", "type": "string" }, "ip_restriction": { "$ref": "#/components/schemas/IPRestriction" }, "last_used_time": { "format": "date-time", "type": "string" }, "metadata": { "description": "metadata is a free-form JSON object for caller-defined attributes\n(e.g., source, environment, tags). Values may be strings, numbers,\nbooleans, arrays, objects, or null. Total serialized size is capped\nat 4KB. AIP-148 metadata field.", "type": "object" }, "name": { "type": "string" }, "rate_limit_policy": { "$ref": "#/components/schemas/RateLimitPolicy" }, "revocation_description": { "description": "revocation_description provides free-form context for a revocation.\nOnly set when revocation_reason is PRIVILEGE_WITHDRAWN.\nJSON API change: field was formerly revocation_reason_text. Field number 13\nis unchanged so the change is wire-compatible for binary proto encoding.", "type": "string" }, "revocation_reason": { "$ref": "#/components/schemas/RevocationReason" }, "scopes": { "items": { "type": "string" }, "type": "array" }, "status": { "$ref": "#/components/schemas/KeyStatus" }, "update_time": { "format": "date-time", "type": "string" }, "visibility": { "$ref": "#/components/schemas/KeyVisibility" } }, "type": "object" } } }, "required": true, "x-originalParamName": "issued_api_key" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IssuedApiKey" } } }, "description": "A successful response." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "An unexpected error response." } }, "security": [ { "oryAccessToken": [] } ], "summary": "Update Issued API Key", "tags": [ "ApiKeys" ] } }, "/v2alpha1/admin/issuedApiKeys/{key_id}:revoke": { "post": { "description": "Immediately revokes an issued API key. Once revoked, the key can no longer\nbe used for authentication. This operation is irreversible. Revoked keys\nare retained for audit purposes.\n\n```http\nPOST /v2alpha1/admin/issuedApiKeys/01HQZX9VYQKJB8XQZQXQZQXQXQ:revoke\n{\n \"reason\": \"REVOCATION_REASON_KEY_COMPROMISE\"\n}\n```", "operationId": "adminRevokeIssuedApiKey", "parameters": [ { "description": "UUID of the issued key (REQUIRED)", "in": "path", "name": "key_id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRevokeIssuedApiKeyBody" } } }, "required": true, "x-originalParamName": "body" }, "responses": { "204": { "description": "API key revoked successfully." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "An unexpected error response." } }, "security": [ { "oryAccessToken": [] } ], "summary": "Revoke Issued API Key", "tags": [ "ApiKeys" ] } }, "/v2alpha1/admin/issuedApiKeys/{key_id}:rotate": { "post": { "description": "Generates a new secret for an issued API key. Creates a new API key with a\nnew key_id and secret, and immediately revokes the old key. This is the\nrecommended way to update scopes, metadata, or rotate credentials.\n\nFor zero-downtime rotation, use this workflow instead:\n 1. IssueApiKey with new credentials\n 2. Deploy new secret to all services\n 3. Verify new secret works everywhere\n 4. AdminRevokeIssuedApiKey to remove the old key\n\n```http\nPOST /v2alpha1/admin/issuedApiKeys/01HQZX9VYQKJB8XQZQXQZQXQXQ:rotate\n{\n \"scopes\": [\"read\"]\n}\n```", "operationId": "adminRotateIssuedApiKey", "parameters": [ { "description": "key_id is the ID of the existing API key to rotate", "in": "path", "name": "key_id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRotateIssuedApiKeyBody" } } }, "required": true, "x-originalParamName": "body" }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RotateIssuedApiKeyResponse" } } }, "description": "API key rotated successfully. New key issued, old key revoked." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "An unexpected error response." } }, "security": [ { "oryAccessToken": [] } ], "summary": "Rotate Issued API Key", "tags": [ "ApiKeys" ] } }, "/v2alpha1/apiKeys:selfRevoke": { "post": { "description": "Proof-of-possession variant of revocation. The `Self*` prefix on the\nrequest/response messages disambiguates from the admin variants\n(`AdminRevokeIssuedApiKey` / `AdminRevokeImportedApiKey`).\n\nAllows an API key holder to revoke their own key. The caller must provide\nthe full API key secret as proof of possession. Supports issued API keys\nand imported keys. JWT and macaroon tokens cannot be self-revoked (they\nare stateless).\n\nThe PRIVILEGE_WITHDRAWN reason is not allowed for self-revocation\n(admin-only).\n\n```http\nPOST /v2alpha1/apiKeys:selfRevoke\n{\n \"credential\": \"sk_live_abc123...\",\n \"reason\": \"REVOCATION_REASON_KEY_COMPROMISE\"\n}\n```", "operationId": "revokeApiKey", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SelfRevokeApiKeyRequest" } } }, "description": "SelfRevokeApiKeyRequest allows an API key holder to revoke their own key\nby providing the full key secret as proof of possession.", "required": true, "x-originalParamName": "body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SelfRevokeApiKeyResponse" } } }, "description": "A successful response." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "An unexpected error response." } }, "summary": "Revoke API Key (self-service)", "tags": [ "ApiKeys" ] } }, "/v2alpha1/derivedKeys/jwks.json": { "get": { "description": "Returns the JSON Web Key Set for token verification. Provides the public\nkeys needed to verify JWT tokens issued by this service. Keys are loaded\nfrom configuration (file://, https://, or base64:// URIs). Follows the\nJWKS standard (RFC 7517).\n\n```http\nGET /v2alpha1/derivedKeys/jwks.json\n```", "operationId": "getJwks", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetJWKSResponse" } } }, "description": "A successful response." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "An unexpected error response." } }, "summary": "Get JWKS", "tags": [ "ApiKeys" ] } }, "/version": { "get": { "description": "This endpoint returns the version of Ory Kratos.\n\nIf the service supports TLS Edge Termination, this endpoint does not require the\n`X-Forwarded-Proto` header to be set.\n\nBe aware that if you are running multiple nodes of this service, the version will never\nrefer to the cluster state, only to a single instance.", "operationId": "getVersion", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "version": { "description": "The version of Ory Kratos.", "type": "string" } }, "required": [ "version" ], "type": "object" } } }, "description": "Returns the Ory Kratos version." } }, "security": [ { "oryAccessToken": [] } ], "summary": "Return Running Software Version.", "tags": [ "metadata" ] } }, "/workspaces": { "get": { "operationId": "listWorkspaces", "parameters": [ { "description": "Items per Page\n\nThis is the number of items per page to return.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_size", "schema": { "default": 250, "format": "int64", "maximum": 1000, "minimum": 1, "type": "integer" } }, { "description": "Next Page Token\n\nThe next page token.\nFor details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).", "in": "query", "name": "page_token", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/listWorkspaces" } } }, "description": "listWorkspaces" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "List workspaces the user is a member of", "tags": [ "workspace" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" }, "post": { "operationId": "createWorkspace", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/createWorkspaceBody" } } }, "x-originalParamName": "Body" }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/workspace" } } }, "description": "workspace" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Create a new workspace", "tags": [ "workspace" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" } }, "/workspaces/{workspace}": { "get": { "description": "Any workspace member can access this endpoint.", "operationId": "getWorkspace", "parameters": [ { "in": "path", "name": "workspace", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/workspace" } } }, "description": "workspace" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Get a workspace", "tags": [ "workspace" ], "x-ory-ratelimit-bucket": "backoffice-admin-medium" }, "put": { "description": "Workspace members with the role `OWNER` can access this endpoint.", "operationId": "updateWorkspace", "parameters": [ { "in": "path", "name": "workspace", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/updateWorkspaceBody" } } }, "x-originalParamName": "Body" }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/workspace" } } }, "description": "workspace" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Update an workspace", "tags": [ "workspace" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" } }, "/workspaces/{workspace}/projects": { "get": { "description": "Any workspace member can access this endpoint.", "operationId": "listWorkspaceProjects", "parameters": [ { "in": "path", "name": "workspace", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/listWorkspaceProjects" } } }, "description": "listWorkspaceProjects" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "List all projects of a workspace", "tags": [ "workspace" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" } }, "/workspaces/{workspace}/tokens": { "get": { "description": "A list of all the workspace's API keys.", "operationId": "listWorkspaceApiKeys", "parameters": [ { "description": "The Workspace ID or Workspace slug", "in": "path", "name": "workspace", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/workspaceApiKeys" } } }, "description": "workspaceApiKeys" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "List a workspace's API keys", "tags": [ "workspace" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" }, "post": { "description": "Create an API key for a workspace.", "operationId": "createWorkspaceApiKey", "parameters": [ { "description": "The Workspace ID", "in": "path", "name": "workspace", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateWorkspaceApiKeyBody" } } }, "x-originalParamName": "Body" }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/workspaceApiKey" } } }, "description": "workspaceApiKey" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Create workspace API key", "tags": [ "workspace" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" } }, "/workspaces/{workspace}/tokens/{token_id}": { "delete": { "description": "Deletes an API key and immediately removes it.", "operationId": "deleteWorkspaceApiKey", "parameters": [ { "description": "The Workspace ID or Workspace slug", "in": "path", "name": "workspace", "required": true, "schema": { "type": "string" } }, { "description": "The Token ID", "in": "path", "name": "token_id", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "$ref": "#/components/responses/emptyResponse" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorGeneric" } } }, "description": "errorGeneric" } }, "security": [ { "oryWorkspaceApiKey": [] } ], "servers": [ { "description": "The Ory Network control plane API which is used to manage your Ory Network projects and workspaces.", "url": "https://api.console.ory.sh" } ], "summary": "Delete workspace API key", "tags": [ "workspace" ], "x-ory-ratelimit-bucket": "backoffice-admin-low" } } }, "servers": [ { "url": "https://{project_slug}.projects.oryapis.com/", "variables": { "project_slug": { "default": "playground", "description": "Your Ory Network Project slug. You can find it in the [Ory Network Console](https://console.ory.sh/projects/current/get-started)." } } } ], "tags": [ { "description": "APIs for managing identities.", "name": "identity" }, { "description": "Endpoints used by frontend applications (e.g. Single-Page-App, Native Apps, Server Apps, ...) to manage a user's own profile.", "name": "frontend" }, { "description": "APIs for managing email and SMS message delivery.", "name": "courier" }, { "description": "Server Metadata provides relevant information about the running server. Only available when self-hosting this service.", "name": "metadata" } ], "x-forwarded-proto": "string", "x-request-id": "string", "x-tagGroups": [ { "name": "Ory Identities", "tags": [ "frontend", "identity", "courier" ] }, { "name": "Ory OAuth2", "tags": [ "wellknown", "oAuth2", "oidc", "jwk" ] }, { "name": "Ory Permissions", "tags": [ "permission", "relationship" ] }, { "name": "Ory Network", "tags": [ "project", "workspace", "events", "metadata" ] } ] }