Create Login Flow for Native Apps

GET 
https://accounts.<domain>/auth/self-service/login/api

This endpoint initiates a login flow for native apps that do not use a browser, such as mobile devices, smart TVs, and so on.

If a valid provided session cookie or session token is provided, a 400 Bad Request error will be returned unless the URL query parameter ?refresh=true is set.

To fetch an existing login flow call /login/flows?flow=<flow_id>.

You MUST NOT use this endpoint in client-side (Single Page Apps, ReactJS, AngularJS) nor server-side (Java Server Pages, NodeJS, PHP, Golang, ...) browser applications. Using this endpoint in these applications will make you vulnerable to a variety of CSRF attacks, including CSRF login attacks.

In the case of an error, the error.id of the JSON response body can be one of:

session_already_available: The user is already signed in. session_aal1_required: Multi-factor auth (e.g. 2fa) was requested but the user has no session yet. security_csrf_violation: Unable to fetch the flow because a CSRF violation occurred.

This endpoint MUST ONLY be used in scenarios such as native mobile apps (React Native, Objective C, Swift, Java, ...).

Request

Query Parameters

refresh boolean

Refresh a login session

If set to true, this will refresh an existing login session by asking the user to sign in again. This will reset the authenticated_at time of the session.

aal string

Request a Specific AuthenticationMethod Assurance Level

Use this parameter to upgrade an existing session's authenticator assurance level (AAL). This allows you to ask for multi-factor authentication. When an identity sign in using e.g. username+password, the AAL is 1. If you wish to "upgrade" the session's security by asking the user to perform TOTP / WebAuth/ ... you would set this to "aal2".

return_session_token_exchange_code boolean

EnableSessionTokenExchangeCode requests the login flow to include a code that can be used to retrieve the session token after the login flow has been completed.

return_to string

The URL to return the browser to after the flow was completed.

Header Parameters

X-Session-Token string

The Session Token of the Identity performing the settings flow.

Responses

200

loginFlow

application/json

Schema

Schema

activeCredentialsType represents several different credential types, like password credentials, passwordless credentials, (string)

and so on.

Possible values: [password, totp, oidc, webauthn, lookup_secret, code]

created_atstring<date-time>

CreatedAt is a helper struct field for gobuffalo.pop.

expires_atstring<date-time>required

ExpiresAt is the time (UTC) when the flow expires. If the user still wishes to log in, a new flow has to be initiated.

idstring<uuid>required

ID represents the flow's unique ID. When performing the login flow, this represents the id in the login UI's query parameter: http://<selfservice.flows.login.ui_url>/?flow=<flow_id>

issued_atstring<date-time>required

IssuedAt is the time (UTC) when the flow started.

oauth2_login_challengestring

OAuth 2.0 Login Challenge.

This value is set using the login_challenge query parameter of the registration and login endpoints. If set will cooperate with OAuth2 and OpenID to act as an OAuth2 server / OpenID Provider.

oauth2_login_request object

OAuth2LoginRequest struct for OAuth2LoginRequest

AdditionalProperties object

property name*any

challengestring

ID is the identifier ("login challenge") of the login request. It is used to identify the session.

client object

AdditionalProperties object

property name*any

access_token_strategystring

OAuth 2.0 Access Token Strategy AccessTokenStrategy is the strategy used to generate access tokens. Valid options are jwt and opaque.

allowed_cors_originsstring[]

audiencestring[]

authorization_code_grant_access_token_lifespanstring

Specify a time duration in milliseconds, seconds, minutes, hours.

authorization_code_grant_id_token_lifespanstring

Specify a time duration in milliseconds, seconds, minutes, hours.

authorization_code_grant_refresh_token_lifespanstring

Specify a time duration in milliseconds, seconds, minutes, hours.

backchannel_logout_session_requiredboolean

OpenID Connect Back-Channel Logout Session Required Boolean value specifying whether the RP requires that a sid (session ID) Claim be included in the Logout Token to identify the RP session with the OP when the backchannel_logout_uri is used. If omitted, the default value is false.

backchannel_logout_uristring

OpenID Connect Back-Channel Logout URI RP URL that will cause the RP to log itself out when sent a Logout Token by the OP.

client_credentials_grant_access_token_lifespanstring

Specify a time duration in milliseconds, seconds, minutes, hours.

client_idstring

OAuth 2.0 Client ID The ID is autogenerated and immutable.

client_namestring

OAuth 2.0 Client Name The human-readable name of the client to be presented to the end-user during authorization.

client_secretstring

OAuth 2.0 Client Secret The secret will be included in the create request as cleartext, and then never again. The secret is kept in hashed format and is not recoverable once lost.

client_secret_expires_atinteger<int64>

OAuth 2.0 Client Secret Expires At The field is currently not supported and its value is always 0.

client_uristring

OAuth 2.0 Client URI ClientURI is a URL string of a web page providing information about the client. If present, the server SHOULD display this URL to the end-user in a clickable fashion.

contactsstring[]

created_atstring<date-time>

OAuth 2.0 Client Creation Date CreatedAt returns the timestamp of the client's creation.

frontchannel_logout_session_requiredboolean

OpenID Connect Front-Channel Logout Session Required Boolean value specifying whether the RP requires that iss (issuer) and sid (session ID) query parameters be included to identify the RP session with the OP when the frontchannel_logout_uri is used. If omitted, the default value is false.

frontchannel_logout_uristring

OpenID Connect Front-Channel Logout URI RP URL that will cause the RP to log itself out when rendered in an iframe by the OP. An iss (issuer) query parameter and a sid (session ID) query parameter MAY be included by the OP to enable the RP to validate the request and to determine which of the potentially multiple sessions is to be logged out; if either is included, both MUST be.

grant_typesstring[]

implicit_grant_access_token_lifespanstring

Specify a time duration in milliseconds, seconds, minutes, hours.

implicit_grant_id_token_lifespanstring

Specify a time duration in milliseconds, seconds, minutes, hours.

jwks

OAuth 2.0 Client JSON Web Key Set Client's JSON Web Key Set [JWK] document, passed by value. The semantics of the jwks parameter are the same as the jwks_uri parameter, other than that the JWK Set is passed by value, rather than by reference. This parameter is intended only to be used by Clients that, for some reason, are unable to use the jwks_uri parameter, for instance, by native applications that might not have a location to host the contents of the JWK Set. If a Client can use jwks_uri, it MUST NOT use jwks. One significant downside of jwks is that it does not enable key rotation (which jwks_uri does, as described in Section 10 of OpenID Connect Core 1.0 [OpenID.Core]). The jwks_uri and jwks parameters MUST NOT be used together.

jwks_uristring

OAuth 2.0 Client JSON Web Key Set URL URL for the Client's JSON Web Key Set [JWK] document. If the Client signs requests to the Server, it contains the signing key(s) the Server uses to validate signatures from the Client. The JWK Set MAY also contain the Client's encryption keys(s), which are used by the Server to encrypt responses to the Client. When both signing and encryption keys are made available, a use (Key Use) parameter value is REQUIRED for all keys in the referenced JWK Set to indicate each key's intended usage. Although some algorithms allow the same key to be used for both signatures and encryption, doing so is NOT RECOMMENDED, as it is less secure. The JWK x5c parameter MAY be used to provide X.509 representations of keys provided. When used, the bare key values MUST still be present and MUST match those in the certificate.

jwt_bearer_grant_access_token_lifespanstring

Specify a time duration in milliseconds, seconds, minutes, hours.

logo_uristring

OAuth 2.0 Client Logo URI A URL string referencing the client's logo.

metadata

ownerstring

OAuth 2.0 Client Owner Owner is a string identifying the owner of the OAuth 2.0 Client.

policy_uristring

OAuth 2.0 Client Policy URI PolicyURI is a URL string that points to a human-readable privacy policy document that describes how the deployment organization collects, uses, retains, and discloses personal data.

post_logout_redirect_urisstring[]

redirect_urisstring[]

refresh_token_grant_access_token_lifespanstring

Specify a time duration in milliseconds, seconds, minutes, hours.

refresh_token_grant_id_token_lifespanstring

Specify a time duration in milliseconds, seconds, minutes, hours.

refresh_token_grant_refresh_token_lifespanstring

Specify a time duration in milliseconds, seconds, minutes, hours.

registration_access_tokenstring

OpenID Connect Dynamic Client Registration Access Token RegistrationAccessToken can be used to update, get, or delete the OAuth2 Client. It is sent when creating a client using Dynamic Client Registration.

registration_client_uristring

OpenID Connect Dynamic Client Registration URL RegistrationClientURI is the URL used to update, get, or delete the OAuth2 Client.

request_object_signing_algstring

OpenID Connect Request Object Signing Algorithm JWS [JWS] alg algorithm [JWA] that MUST be used for signing Request Objects sent to the OP. All Request Objects from this Client MUST be rejected, if not signed with this algorithm.

request_urisstring[]

response_typesstring[]

scopestring

OAuth 2.0 Client Scope Scope is a string containing a space-separated list of scope values (as described in Section 3.3 of OAuth 2.0 [RFC6749]) that the client can use when requesting access tokens.

sector_identifier_uristring

OpenID Connect Sector Identifier URI URL using the https scheme to be used in calculating Pseudonymous Identifiers by the OP. The URL references a file with a single JSON array of redirect_uri values.

skip_consentboolean

SkipConsent skips the consent screen for this client. This field can only be set from the admin API.

subject_typestring

OpenID Connect Subject Type The subject_types_supported Discovery parameter contains a list of the supported subject_type values for this server. Valid types include pairwise and public.

token_endpoint_auth_methodstring

OAuth 2.0 Token Endpoint Authentication Method Requested Client Authentication method for the Token Endpoint. The options are: client_secret_basic: (default) Send client_id and client_secret as application/x-www-form-urlencoded encoded in the HTTP Authorization header. client_secret_post: Send client_id and client_secret as application/x-www-form-urlencoded in the HTTP body. private_key_jwt: Use JSON Web Tokens to authenticate the client. none: Used for public clients (native apps, mobile apps) which can not have secrets.

token_endpoint_auth_signing_algstring

OAuth 2.0 Token Endpoint Signing Algorithm Requested Client Authentication signing algorithm for the Token Endpoint.

tos_uristring

OAuth 2.0 Client Terms of Service URI A URL string pointing to a human-readable terms of service document for the client that describes a contractual relationship between the end-user and the client that the end-user accepts when authorizing the client.

updated_atstring<date-time>

OAuth 2.0 Client Last Update Date UpdatedAt returns the timestamp of the last update.

userinfo_signed_response_algstring

OpenID Connect Request Userinfo Signed Response Algorithm JWS alg algorithm [JWA] REQUIRED for signing UserInfo Responses. If this is specified, the response will be JWT [JWT] serialized, and signed using JWS. The default, if omitted, is for the UserInfo Response to return the Claims as a UTF-8 encoded JSON object using the application/json content-type.

oidc_context object

OAuth2ConsentRequestOpenIDConnectContext struct for OAuth2ConsentRequestOpenIDConnectContext

AdditionalProperties object

property name*any

acr_valuesstring[]

ACRValues is the Authentication AuthorizationContext Class Reference requested in the OAuth 2.0 Authorization request. It is a parameter defined by OpenID Connect and expresses which level of authentication (e.g. 2FA) is required. OpenID Connect defines it as follows: > Requested Authentication AuthorizationContext Class Reference values. Space-separated string that specifies the acr values that the Authorization Server is being requested to use for processing this Authentication Request, with the values appearing in order of preference. The Authentication AuthorizationContext Class satisfied by the authentication performed is returned as the acr Claim Value, as specified in Section 2. The acr Claim is requested as a Voluntary Claim by this parameter.

displaystring

Display is a string value that specifies how the Authorization Server displays the authentication and consent user interface pages to the End-User. The defined values are: page: 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. popup: 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. touch: The Authorization Server SHOULD display the authentication and consent UI consistent with a device that leverages a touch interface. wap: The Authorization Server SHOULD display the authentication and consent UI consistent with a "feature phone" type display. The Authorization Server MAY also attempt to detect the capabilities of the User Agent and present an appropriate display.

id_token_hint_claims object

IDTokenHintClaims are the claims of the ID Token previously issued by the Authorization Server being passed as a hint about the End-User's current or past authenticated session with the Client.

property name*any

IDTokenHintClaims are the claims of the ID Token previously issued by the Authorization Server being passed as a hint about the End-User's current or past authenticated session with the Client.

login_hintstring

LoginHint hints about the login identifier the End-User might use to log in (if necessary). This hint can be used by an RP if it first asks the End-User for their e-mail address (or other identifier) and then wants to pass that value as a hint to the discovered authorization service. This value MAY also be a phone number in the format specified for the phone_number Claim. The use of this parameter is optional.

ui_localesstring[]

UILocales is the End-User'id preferred languages and scripts for the user interface, represented as a space-separated list of BCP47 [RFC5646] language tag values, ordered by preference. For instance, the value "fr-CA fr en" represents a preference for French as spoken in Canada, then French (without a region designation), followed by English (without a region designation). An error SHOULD NOT result if some or all of the requested locales are not supported by the OpenID Provider.

request_urlstring

RequestURL is the original OAuth 2.0 Authorization URL requested by the OAuth 2.0 client. It is the URL which initiates the OAuth 2.0 Authorization Code or OAuth 2.0 Implicit flow. This URL is typically not needed, but might come in handy if you want to deal with additional request parameters.

requested_access_token_audiencestring[]

requested_scopestring[]

session_idstring

SessionID is the login session ID. If the user-agent reuses a login session (via cookie / remember flag) this ID will remain the same. If the user-agent did not have an existing authentication session (e.g. remember is false) this will be a new random value. This value is used as the "sid" parameter in the ID Token and in OIDC Front-/Back- channel logout. It's value can generally be used to associate consecutive login requests by a certain user.

skipboolean

Skip, if true, implies that the client has requested the same scopes from the same user previously. If true, you can skip asking the user to grant the requested scopes, and simply forward the user to the redirect URL. This feature allows you to update / set session information.

subjectstring

Subject is the user ID of the end-user that authenticated. Now, that end user needs to grant or deny the scope requested by the OAuth 2.0 client. If this value is set and skip is true, you MUST include this subject type when accepting the login request, or the request will fail.

organization_idstring<uuid4>nullable
refreshboolean

Refresh stores whether this login flow should enforce re-authentication.

request_urlstringrequired

RequestURL is the initial URL that was requested. It can be used to forward information contained in the URL's path or query for example.

requested_aalAuthenticator Assurance Level (AAL) (string)

The authenticator assurance level can be one of "aal1", "aal2", or "aal3". A higher number means that it is harder for an attacker to compromise the account.

Generally, "aal1" implies that one authentication factor was used while AAL2 implies that two factors (e.g. password + TOTP) have been used.

Possible values: [aal0, aal1, aal2, aal3]

return_tostring

ReturnTo contains the requested return_to URL.

session_token_exchange_codestring

SessionTokenExchangeCode holds the secret code that the client can use to retrieve a session token after the login flow has been completed. This is only set if the client has requested a session token exchange code, and if the flow is of type "api", and only on creating the login flow.

staterequired

State represents the state of this request:

choose_method: ask the user to choose a method to sign in with sent_email: the email has been sent to the user passed_challenge: the request was successful and the login challenge was passed.

typeType is the flow type. (string)required

The flow type can either be api or browser.

ui objectrequired
Container represents a HTML Form. The container can work with both HTTP Form and JSON requests
actionstringrequired
Action should be used as the form action URL <form action="{{ .Action }}" method="post">.
messages object[]
Array [
contextobject
The message's context. Useful when customizing messages.
idinteger<int64>required
textstringrequired
The message text. Written in american english.
typestringrequired
The message type. info Info error Error success Success
Possible values: [info, error, success]
]
methodstringrequired
Method is the form method (e.g. POST)
nodes object[]required
Array [
attributes objectrequired
node_typerequired
Possible values: [a, img, input, script, text]
a
hrefstringrequired
The link's href (destination) URL.
format: uri
idstringrequired
A unique identifier
title objectrequired
contextobject
The message's context. Useful when customizing messages.
idinteger<int64>required
textstringrequired
The message text. Written in american english.
typestringrequired
The message type. info Info error Error success Success
Possible values: [info, error, success]
img
heightinteger<int64>required
Height of the image
idstringrequired
A unique identifier
srcstringrequired
The image's source URL.
format: uri
widthinteger<int64>required
Width of the image
input
autocompletestring
The autocomplete attribute for the input. email InputAttributeAutocompleteEmail tel InputAttributeAutocompleteTel url InputAttributeAutocompleteUrl current-password InputAttributeAutocompleteCurrentPassword new-password InputAttributeAutocompleteNewPassword one-time-code InputAttributeAutocompleteOneTimeCode
Possible values: [email, tel, url, current-password, new-password, one-time-code]
disabledbooleanrequired
Sets the input's disabled field to true or false.
label object
contextobject
The message's context. Useful when customizing messages.
idinteger<int64>required
textstringrequired
The message text. Written in american english.
typestringrequired
The message type. info Info error Error success Success
Possible values: [info, error, success]
namestringrequired
The input's element name.
onclickstring
OnClick may contain javascript which should be executed on click. This is primarily used for WebAuthn.
patternstring
The input's pattern.
requiredboolean
Mark this input field as required.
typestringrequired
The input's element type. text InputAttributeTypeText password InputAttributeTypePassword number InputAttributeTypeNumber checkbox InputAttributeTypeCheckbox hidden InputAttributeTypeHidden email InputAttributeTypeEmail tel InputAttributeTypeTel submit InputAttributeTypeSubmit button InputAttributeTypeButton datetime-local InputAttributeTypeDateTimeLocal date InputAttributeTypeDate url InputAttributeTypeURI
Possible values: [text, password, number, checkbox, hidden, email, tel, submit, button, datetime-local, date, url]
valuenullable
The input's value.
script
asyncbooleanrequired
The script async type
crossoriginstringrequired
The script cross origin policy
idstringrequired
A unique identifier
integritystringrequired
The script's integrity hash
noncestringrequired
Nonce for CSP
A nonce you may want to use to improve your Content Security Policy. You do not have to use this value but if you want to improve your CSP policies you may use it. You can also choose to use your own nonce value!
referrerpolicystringrequired
The script referrer policy
srcstringrequired
The script source
typestringrequired
The script MIME type
text
idstringrequired
A unique identifier
text objectrequired
contextobject
The message's context. Useful when customizing messages.
idinteger<int64>required
textstringrequired
The message text. Written in american english.
typestringrequired
The message type. info Info error Error success Success
Possible values: [info, error, success]
groupstringrequired
Group specifies which group (e.g. password authenticator) this node belongs to. default DefaultGroup password PasswordGroup oidc OpenIDConnectGroup profile ProfileGroup link LinkGroup code CodeGroup totp TOTPGroup lookup_secret LookupGroup webauthn WebAuthnGroup
Possible values: [default, password, oidc, profile, link, code, totp, lookup_secret, webauthn]
messages object[]required
Array [
contextobject
The message's context. Useful when customizing messages.
idinteger<int64>required
textstringrequired
The message text. Written in american english.
typestringrequired
The message type. info Info error Error success Success
Possible values: [info, error, success]
]
meta objectrequired
This might include a label and other information that can optionally be used to render UIs.
label object
contextobject
The message's context. Useful when customizing messages.
idinteger<int64>required
textstringrequired
The message text. Written in american english.
typestringrequired
The message type. info Info error Error success Success
Possible values: [info, error, success]
typestringrequired
The node's type text Text input Input img Image a Anchor script Script
Possible values: [text, input, img, a, script]
]
updated_atstring<date-time>

UpdatedAt is a helper struct field for gobuffalo.pop.

Example (auto)

{
  "active": "password",
  "created_at": "2024-07-29T15:51:28.071Z",
  "expires_at": "2024-07-29T15:51:28.071Z",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "issued_at": "2024-07-29T15:51:28.071Z",
  "oauth2_login_challenge": "string",
  "oauth2_login_request": {
    "AdditionalProperties": {},
    "challenge": "string",
    "client": {
      "AdditionalProperties": {},
      "access_token_strategy": "string",
      "allowed_cors_origins": [
        "string"
      ],
      "audience": [
        "string"
      ],
      "authorization_code_grant_access_token_lifespan": "string",
      "authorization_code_grant_id_token_lifespan": "string",
      "authorization_code_grant_refresh_token_lifespan": "string",
      "backchannel_logout_session_required": true,
      "backchannel_logout_uri": "string",
      "client_credentials_grant_access_token_lifespan": "string",
      "client_id": "string",
      "client_name": "string",
      "client_secret": "string",
      "client_secret_expires_at": 0,
      "client_uri": "string",
      "contacts": [
        "string"
      ],
      "created_at": "2024-07-29T15:51:28.071Z",
      "frontchannel_logout_session_required": true,
      "frontchannel_logout_uri": "string",
      "grant_types": [
        "string"
      ],
      "implicit_grant_access_token_lifespan": "string",
      "implicit_grant_id_token_lifespan": "string",
      "jwks_uri": "string",
      "jwt_bearer_grant_access_token_lifespan": "string",
      "logo_uri": "string",
      "metadata": {},
      "owner": "string",
      "policy_uri": "string",
      "post_logout_redirect_uris": [
        "string"
      ],
      "redirect_uris": [
        "string"
      ],
      "refresh_token_grant_access_token_lifespan": "string",
      "refresh_token_grant_id_token_lifespan": "string",
      "refresh_token_grant_refresh_token_lifespan": "string",
      "registration_access_token": "string",
      "registration_client_uri": "string",
      "request_object_signing_alg": "string",
      "request_uris": [
        "string"
      ],
      "response_types": [
        "string"
      ],
      "scope": "string",
      "sector_identifier_uri": "string",
      "skip_consent": true,
      "subject_type": "string",
      "token_endpoint_auth_method": "string",
      "token_endpoint_auth_signing_alg": "string",
      "tos_uri": "string",
      "updated_at": "2024-07-29T15:51:28.071Z",
      "userinfo_signed_response_alg": "string"
    },
    "oidc_context": {
      "AdditionalProperties": {},
      "acr_values": [
        "string"
      ],
      "display": "string",
      "id_token_hint_claims": {},
      "login_hint": "string",
      "ui_locales": [
        "string"
      ]
    },
    "request_url": "string",
    "requested_access_token_audience": [
      "string"
    ],
    "requested_scope": [
      "string"
    ],
    "session_id": "string",
    "skip": true,
    "subject": "string"
  },
  "organization_id": "string",
  "refresh": true,
  "request_url": "string",
  "requested_aal": "aal0",
  "return_to": "string",
  "session_token_exchange_code": "string",
  "type": "string",
  "ui": {
    "action": "string",
    "messages": [
      {
        "context": {},
        "id": 0,
        "text": "string",
        "type": "info"
      }
    ],
    "method": "string",
    "nodes": [
      {
        "attributes": {
          "autocomplete": "email",
          "disabled": true,
          "label": {
            "context": {},
            "id": 0,
            "text": "string",
            "type": "info"
          },
          "name": "string",
          "node_type": "string",
          "onclick": "string",
          "pattern": "string",
          "required": true,
          "type": "text"
        },
        "group": "default",
        "messages": [
          {
            "context": {},
            "id": 0,
            "text": "string",
            "type": "info"
          }
        ],
        "meta": {
          "label": {
            "context": {},
            "id": 0,
            "text": "string",
            "type": "info"
          }
        },
        "type": "text"
      }
    ]
  },
  "updated_at": "2024-07-29T15:51:28.071Z"
}

400

errorGeneric

application/json

Schema

Schema

error objectrequired
codeinteger<int64>
The status code
Example: 404
debugstring
Debug information
This field is often not exposed to protect against leaking sensitive information.
Example: SQL field "foo" is not a bool.
detailsobject
Further error details
idstring
The error ID
Useful when trying to identify various errors in application logic.
messagestringrequired
Error message
The error's message.
Example: The resource could not be found
reasonstring
A human-readable reason for the error
Example: User with ID 1234 does not exist.
requeststring
The request ID
The request ID is often exposed internally in order to trace errors across service architectures. This is often a UUID.
Example: d7ef54b1-ec15-46e6-bccb-524b82c035e6
statusstring
The status description
Example: Not Found

Example (auto)

{
  "error": {
    "code": 404,
    "debug": "SQL field \"foo\" is not a bool.",
    "details": {},
    "id": "string",
    "message": "The resource could not be found",
    "reason": "User with ID 1234 does not exist.",
    "request": "d7ef54b1-ec15-46e6-bccb-524b82c035e6",
    "status": "Not Found"
  }
}

default

errorGeneric

application/json

Schema

Schema

error objectrequired
codeinteger<int64>
The status code
Example: 404
debugstring
Debug information
This field is often not exposed to protect against leaking sensitive information.
Example: SQL field "foo" is not a bool.
detailsobject
Further error details
idstring
The error ID
Useful when trying to identify various errors in application logic.
messagestringrequired
Error message
The error's message.
Example: The resource could not be found
reasonstring
A human-readable reason for the error
Example: User with ID 1234 does not exist.
requeststring
The request ID
The request ID is often exposed internally in order to trace errors across service architectures. This is often a UUID.
Example: d7ef54b1-ec15-46e6-bccb-524b82c035e6
statusstring
The status description
Example: Not Found

Example (auto)

{
  "error": {
    "code": 404,
    "debug": "SQL field \"foo\" is not a bool.",
    "details": {},
    "id": "string",
    "message": "The resource could not be found",
    "reason": "User with ID 1234 does not exist.",
    "request": "d7ef54b1-ec15-46e6-bccb-524b82c035e6",
    "status": "Not Found"
  }
}

• csharp
• curl
• dart
• go
• http
• java
• javascript
• kotlin
• c
• nodejs
• objective-c
• ocaml
• php
• powershell
• python
• r
• ruby
• rust
• shell
• swift

• HTTPCLIENT
• RESTSHARP

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://accounts.<domain>/auth/self-service/login/api");
request.Headers.Add("Accept", "application/json");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Request Collapse all

Base URL

https://accounts.<domain>

Parameters

refresh — query

---truefalse

aal — query

return_session_token_exchange_code — query

---truefalse

return_to — query

X-Session-Token — header