flows_inspector_get
GET/flows/inspector/:flow_slug/
Get current flow state and record it
Request
Path Parameters
Responses
- 200
- 400
- 403
- application/json
- Schema
- Example (from schema)
Schema
Array [
Array [
]
Array [
]
]
Array [
]
Array [
]
plans
object[]
required
current_stage
object
required
FlowStageBinding Serializer
stage_obj
object
required
Stage Serializer
Get object type so that we know how to edit the object
Return object's verbose_name
Return object's plural verbose_name
Return internal model name
flow_set
object[]
Possible values: <= 50 characters
, Value must match regular expression ^[-a-zA-Z0-9_]+$
Visible in the URL.
Shown as the Title in Flow pages.
Possible values: [authentication
, authorization
, invalidation
, enrollment
, unenrollment
, recovery
, stage_configuration
]
Decides what this Flow is used for. For example, the Authentication flow is redirect to when an un-authenticated user visits authentik.
Get the URL to the background image. If the name is /static or starts with http it is returned as-is
Possible values: [all
, any
]
Enable compatibility mode, increases compatibility with password managers on mobile devices.
Get export URL for flow
Possible values: [stacked
, content_left
, content_right
, sidebar_left
, sidebar_right
]
Possible values: [message_continue
, message
, continue
]
Configure what should happen when a flow denies access to a user.
Evaluate policies during the Flow planning process.
Evaluate policies when the Stage is present to the user.
Possible values: >= -2147483648
and <= 2147483647
Possible values: [all
, any
]
Possible values: [retry
, restart
, restart_with_context
]
Configure how the flow executor should handle an invalid response to a challenge. RETRY returns the error message and a similar challenge to the executor. RESTART restarts the flow from the beginning, and RESTART_WITH_CONTEXT restarts the flow while keeping the current context.
next_planned_stage
object
required
FlowStageBinding Serializer
stage_obj
object
required
Stage Serializer
Get object type so that we know how to edit the object
Return object's verbose_name
Return object's plural verbose_name
Return internal model name
flow_set
object[]
Possible values: <= 50 characters
, Value must match regular expression ^[-a-zA-Z0-9_]+$
Visible in the URL.
Shown as the Title in Flow pages.
Possible values: [authentication
, authorization
, invalidation
, enrollment
, unenrollment
, recovery
, stage_configuration
]
Decides what this Flow is used for. For example, the Authentication flow is redirect to when an un-authenticated user visits authentik.
Get the URL to the background image. If the name is /static or starts with http it is returned as-is
Possible values: [all
, any
]
Enable compatibility mode, increases compatibility with password managers on mobile devices.
Get export URL for flow
Possible values: [stacked
, content_left
, content_right
, sidebar_left
, sidebar_right
]
Possible values: [message_continue
, message
, continue
]
Configure what should happen when a flow denies access to a user.
Evaluate policies during the Flow planning process.
Evaluate policies when the Stage is present to the user.
Possible values: >= -2147483648
and <= 2147483647
Possible values: [all
, any
]
Possible values: [retry
, restart
, restart_with_context
]
Configure how the flow executor should handle an invalid response to a challenge. RETRY returns the error message and a similar challenge to the executor. RESTART restarts the flow from the beginning, and RESTART_WITH_CONTEXT restarts the flow while keeping the current context.
plan_context
object
required
Get the plan's context, sanitized
Get a unique session ID
current_plan
object
Serializer for an active FlowPlan
current_stage
object
required
FlowStageBinding Serializer
stage_obj
object
required
Stage Serializer
Get object type so that we know how to edit the object
Return object's verbose_name
Return object's plural verbose_name
Return internal model name
flow_set
object[]
Possible values: <= 50 characters
, Value must match regular expression ^[-a-zA-Z0-9_]+$
Visible in the URL.
Shown as the Title in Flow pages.
Possible values: [authentication
, authorization
, invalidation
, enrollment
, unenrollment
, recovery
, stage_configuration
]
Decides what this Flow is used for. For example, the Authentication flow is redirect to when an un-authenticated user visits authentik.
Get the URL to the background image. If the name is /static or starts with http it is returned as-is
Possible values: [all
, any
]
Enable compatibility mode, increases compatibility with password managers on mobile devices.
Get export URL for flow
Possible values: [stacked
, content_left
, content_right
, sidebar_left
, sidebar_right
]
Possible values: [message_continue
, message
, continue
]
Configure what should happen when a flow denies access to a user.
Evaluate policies during the Flow planning process.
Evaluate policies when the Stage is present to the user.
Possible values: >= -2147483648
and <= 2147483647
Possible values: [all
, any
]
Possible values: [retry
, restart
, restart_with_context
]
Configure how the flow executor should handle an invalid response to a challenge. RETRY returns the error message and a similar challenge to the executor. RESTART restarts the flow from the beginning, and RESTART_WITH_CONTEXT restarts the flow while keeping the current context.
next_planned_stage
object
required
FlowStageBinding Serializer
stage_obj
object
required
Stage Serializer
Get object type so that we know how to edit the object
Return object's verbose_name
Return object's plural verbose_name
Return internal model name
flow_set
object[]
Possible values: <= 50 characters
, Value must match regular expression ^[-a-zA-Z0-9_]+$
Visible in the URL.
Shown as the Title in Flow pages.
Possible values: [authentication
, authorization
, invalidation
, enrollment
, unenrollment
, recovery
, stage_configuration
]
Decides what this Flow is used for. For example, the Authentication flow is redirect to when an un-authenticated user visits authentik.
Get the URL to the background image. If the name is /static or starts with http it is returned as-is
Possible values: [all
, any
]
Enable compatibility mode, increases compatibility with password managers on mobile devices.
Get export URL for flow
Possible values: [stacked
, content_left
, content_right
, sidebar_left
, sidebar_right
]
Possible values: [message_continue
, message
, continue
]
Configure what should happen when a flow denies access to a user.
Evaluate policies during the Flow planning process.
Evaluate policies when the Stage is present to the user.
Possible values: >= -2147483648
and <= 2147483647
Possible values: [all
, any
]
Possible values: [retry
, restart
, restart_with_context
]
Configure how the flow executor should handle an invalid response to a challenge. RETRY returns the error message and a similar challenge to the executor. RESTART restarts the flow from the beginning, and RESTART_WITH_CONTEXT restarts the flow while keeping the current context.
plan_context
object
required
Get the plan's context, sanitized
Get a unique session ID
{
"plans": [
{
"current_stage": {
"pk": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"policybindingmodel_ptr_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"target": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stage": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stage_obj": {
"pk": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"component": "string",
"verbose_name": "string",
"verbose_name_plural": "string",
"meta_model_name": "string",
"flow_set": [
{
"pk": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"policybindingmodel_ptr_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"slug": "string",
"title": "string",
"designation": "authentication",
"background": "string",
"policy_engine_mode": "all",
"compatibility_mode": true,
"export_url": "string",
"layout": "stacked",
"denied_action": "message_continue"
}
]
},
"evaluate_on_plan": true,
"re_evaluate_policies": true,
"order": 0,
"policy_engine_mode": "all",
"invalid_response_action": "retry"
},
"next_planned_stage": {
"pk": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"policybindingmodel_ptr_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"target": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stage": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stage_obj": {
"pk": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"component": "string",
"verbose_name": "string",
"verbose_name_plural": "string",
"meta_model_name": "string",
"flow_set": [
{
"pk": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"policybindingmodel_ptr_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"slug": "string",
"title": "string",
"designation": "authentication",
"background": "string",
"policy_engine_mode": "all",
"compatibility_mode": true,
"export_url": "string",
"layout": "stacked",
"denied_action": "message_continue"
}
]
},
"evaluate_on_plan": true,
"re_evaluate_policies": true,
"order": 0,
"policy_engine_mode": "all",
"invalid_response_action": "retry"
},
"plan_context": {},
"session_id": "string"
}
],
"current_plan": {
"current_stage": {
"pk": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"policybindingmodel_ptr_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"target": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stage": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stage_obj": {
"pk": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"component": "string",
"verbose_name": "string",
"verbose_name_plural": "string",
"meta_model_name": "string",
"flow_set": [
{
"pk": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"policybindingmodel_ptr_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"slug": "string",
"title": "string",
"designation": "authentication",
"background": "string",
"policy_engine_mode": "all",
"compatibility_mode": true,
"export_url": "string",
"layout": "stacked",
"denied_action": "message_continue"
}
]
},
"evaluate_on_plan": true,
"re_evaluate_policies": true,
"order": 0,
"policy_engine_mode": "all",
"invalid_response_action": "retry"
},
"next_planned_stage": {
"pk": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"policybindingmodel_ptr_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"target": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stage": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stage_obj": {
"pk": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"component": "string",
"verbose_name": "string",
"verbose_name_plural": "string",
"meta_model_name": "string",
"flow_set": [
{
"pk": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"policybindingmodel_ptr_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"slug": "string",
"title": "string",
"designation": "authentication",
"background": "string",
"policy_engine_mode": "all",
"compatibility_mode": true,
"export_url": "string",
"layout": "stacked",
"denied_action": "message_continue"
}
]
},
"evaluate_on_plan": true,
"re_evaluate_policies": true,
"order": 0,
"policy_engine_mode": "all",
"invalid_response_action": "retry"
},
"plan_context": {},
"session_id": "string"
},
"is_completed": true
}
No flow plan in session.
- application/json
- Schema
- Example (from schema)
Schema
{
"detail": "string",
"code": "string"
}