flows_executor_solve

POST 
/api/v3//flows/executor/:flow_slug/

Solve the previously retrieved challenge and advanced to the next stage.

Request

Path Parameters

flow_slug stringrequired

Query Parameters

query stringrequired

Querystring as received

application/json

Body

oneOf

AppleChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-source-oauth-apple

AuthenticatorDuoChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-stage-authenticator-duo

AuthenticatorSMSChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-stage-authenticator-sms

code integer

phone_number string

Possible values: non-empty

AuthenticatorStaticChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-stage-authenticator-static

AuthenticatorTOTPChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-stage-authenticator-totp

code integerrequired

AuthenticatorValidationChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-stage-authenticator-validate

selected_challenge

object

Single device challenge

device_class stringrequired

Possible values: non-empty

device_uid stringrequired

Possible values: non-empty

challenge

object

required

selected_stage string

Possible values: non-empty

code string

Possible values: non-empty

webauthn

object

duo integer

AuthenticatorWebAuthnChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-stage-authenticator-webauthn

response

object

required

AutoSubmitChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-stage-autosubmit

CaptchaChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-stage-captcha

token stringrequired

Possible values: non-empty

ConsentChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-stage-consent

token stringrequired

Possible values: non-empty

DummyChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-stage-dummy

EmailChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-stage-email

IdentificationChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-stage-identification

uid_field stringrequired

Possible values: non-empty

password stringnullable

OAuthDeviceCodeChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-provider-oauth2-device-code

code integerrequired

OAuthDeviceCodeFinishChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-provider-oauth2-device-code-finish

PasswordChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-stage-password

password stringrequired

Possible values: non-empty

PlexAuthenticationChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-source-plex

PromptChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-stage-prompt

UserLoginChallengeResponseRequest

component string

Possible values: non-empty

Default value: ak-stage-user-login

remember_me booleanrequired

Responses

200

application/json

Schema

Schema

oneOf

AccessDeniedChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-stage-access-denied

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

pending_user stringrequired

pending_user_avatar stringrequired

error_message string

AppleLoginChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-source-oauth-apple

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

client_id stringrequired

scope stringrequired

redirect_uri stringrequired

state stringrequired

AuthenticatorDuoChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-stage-authenticator-duo

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

pending_user stringrequired

pending_user_avatar stringrequired

activation_barcode stringrequired

activation_code stringrequired

stage_uuid stringrequired

AuthenticatorSMSChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-stage-authenticator-sms

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

pending_user stringrequired

pending_user_avatar stringrequired

phone_number_required boolean

Default value: true

AuthenticatorStaticChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-stage-authenticator-static

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

pending_user stringrequired

pending_user_avatar stringrequired

codes string[]required

AuthenticatorTOTPChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-stage-authenticator-totp

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

pending_user stringrequired

pending_user_avatar stringrequired

config_url stringrequired

AuthenticatorValidationChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-stage-authenticator-validate

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

pending_user stringrequired

pending_user_avatar stringrequired

device_challenges

object[]

required

Array [

device_class stringrequired

device_uid stringrequired

challenge

object

required

]

configuration_stages

object[]

required

Array [

pk uuidrequired

name stringrequired

verbose_name stringrequired

meta_model_name stringrequired

]

AuthenticatorWebAuthnChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-stage-authenticator-webauthn

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

pending_user stringrequired

pending_user_avatar stringrequired

registration

object

required

AutosubmitChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-stage-autosubmit

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

url stringrequired

attrs

object

required

property name* string

title string

CaptchaChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-stage-captcha

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

pending_user stringrequired

pending_user_avatar stringrequired

site_key stringrequired

js_url stringrequired

ConsentChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-stage-consent

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

pending_user stringrequired

pending_user_avatar stringrequired

header_text string

permissions

object[]

required

Array [

name stringrequired

id stringrequired

]

additional_permissions

object[]

required

Array [

name stringrequired

id stringrequired

]

token stringrequired

DummyChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-stage-dummy

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

name stringrequired

EmailChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-stage-email

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

FlowErrorChallenge

type string

Default value: native

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-stage-flow-error

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

request_id stringrequired

error string

traceback string

IdentificationChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-stage-identification

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

user_fields string[]nullablerequired

password_fields booleanrequired

application_pre string

flow_designation FlowDesignationEnum (string)required

Possible values: [authentication, authorization, invalidation, enrollment, unenrollment, recovery, stage_configuration]

enroll_url string

recovery_url string

passwordless_url string

primary_action stringrequired

sources

object[]

Array [

name stringrequired

icon_url stringnullable

challenge

object

required

oneOf

RedirectChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: xak-flow-redirect

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

to stringrequired

PlexAuthenticationChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-source-plex

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

client_id stringrequired

slug stringrequired

AppleLoginChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-source-oauth-apple

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

client_id stringrequired

scope stringrequired

redirect_uri stringrequired

state stringrequired

]

show_source_labels booleanrequired

OAuthDeviceCodeChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-provider-oauth2-device-code

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

OAuthDeviceCodeFinishChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-provider-oauth2-device-code-finish

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

PasswordChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-stage-password

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

pending_user stringrequired

pending_user_avatar stringrequired

recovery_url string

PlexAuthenticationChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-source-plex

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

client_id stringrequired

slug stringrequired

PromptChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-stage-prompt

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

fields

object[]

required

Array [

field_key stringrequired

label stringrequired

type PromptTypeEnum (string)required

Possible values: [text, text_area, text_read_only, text_area_read_only, username, email, password, number, checkbox, radio-button-group, dropdown, date, date-time, file, separator, hidden, static, ak-locale]

required booleanrequired

placeholder stringrequired

initial_value stringrequired

order integerrequired

sub_text stringrequired

choices string[]nullablerequired

]

RedirectChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: xak-flow-redirect

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

to stringrequired

ShellChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: xak-flow-shell

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

body stringrequired

UserLoginChallenge

type ChallengeChoices (string)required

Possible values: [native, shell, redirect]

flow_info

object

Contextual flow information for a challenge

title string

background string

cancel_url stringrequired

layout ContextualFlowInfoLayoutEnum (string)required

Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

component string

Default value: ak-stage-user-login

response_errors

object

property name*

object[]

Array [

string stringrequired

code stringrequired

]

pending_user stringrequired

pending_user_avatar stringrequired

Example (from schema)

{}

400

application/json

Schema

Schema

non_field_errors string[]
code string

Example (from schema)

{
  "non_field_errors": [
    "string"
  ],
  "code": "string"
}

403

application/json

Schema

Schema

detail stringrequired
code string

Example (from schema)

{
  "detail": "string",
  "code": "string"
}

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X POST '/api/v3/flows/executor/:flow_slug/' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "component": "ak-source-oauth-apple"
}'

Request Collapse all

Base URL

/api/v3

Auth

Bearer Token

Parameters

flow_slug — pathrequired

query — queryrequired

Body

{
  "component": "ak-source-oauth-apple"
}