stages_authenticator_validate_partial_update

PATCH 
/api/v3//stages/authenticator/validate/:stage_uuid/

AuthenticatorValidateStage Viewset

Request

Path Parameters

stage_uuid uuidrequired

A UUID string identifying this Authenticator Validation Stage.

application/json

Body

name string

Possible values: non-empty

flow_set

object[]

Array [

name stringrequired

Possible values: non-empty

slug stringrequired

Possible values: non-empty and <= 50 characters, Value must match regular expression ^[-a-zA-Z0-9_]+$

Visible in the URL.

title stringrequired

Possible values: non-empty

Shown as the Title in Flow pages.

designation FlowDesignationEnum (string)required

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

policy_engine_mode PolicyEngineMode (string)

Possible values: [all, any]

compatibility_mode boolean

Enable compatibility mode, increases compatibility with password managers on mobile devices.

layout FlowLayoutEnum (string)

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

denied_action DeniedActionEnum (string)

Possible values: [message_continue, message, continue]

]

not_configured_action NotConfiguredActionEnum (string)

Possible values: [skip, deny, configure]

device_classes DeviceClassesEnum (string)[]

Possible values: [static, totp, webauthn, duo, sms]

Device classes which can be used to authenticate

configuration_stages uuid[]

Stages used to configure Authenticator when user doesn't have any compatible devices. After this configuration Stage passes, the user is not prompted again.

last_auth_threshold string

Possible values: non-empty

If any of the user's device has been used within this threshold, this stage will be skipped

webauthn_user_verification UserVerificationEnum (string)

Possible values: [required, preferred, discouraged]

webauthn_allowed_device_types uuid[]

Responses

200

application/json

Schema

Schema

pk uuidrequired
name stringrequired
component stringrequired

Get object type so that we know how to edit the object

verbose_name stringrequired

Return object's verbose_name

verbose_name_plural stringrequired

Return object's plural verbose_name

meta_model_name stringrequired

Return internal model name

flow_set

object[]

Array [

pk uuidrequired

policybindingmodel_ptr_id uuidrequired

name stringrequired

slug stringrequired

Possible values: <= 50 characters, Value must match regular expression ^[-a-zA-Z0-9_]+$

Visible in the URL.

title stringrequired

Shown as the Title in Flow pages.

designation FlowDesignationEnum (string)required

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

background stringrequired

Get the URL to the background image. If the name is /static or starts with http it is returned as-is

policy_engine_mode PolicyEngineMode (string)

Possible values: [all, any]

compatibility_mode boolean

Enable compatibility mode, increases compatibility with password managers on mobile devices.

export_url stringrequired

Get export URL for flow

layout FlowLayoutEnum (string)

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

denied_action DeniedActionEnum (string)

Possible values: [message_continue, message, continue]

]

not_configured_action NotConfiguredActionEnum (string)

Possible values: [skip, deny, configure]

device_classes DeviceClassesEnum (string)[]

Possible values: [static, totp, webauthn, duo, sms]

Device classes which can be used to authenticate

configuration_stages uuid[]

Stages used to configure Authenticator when user doesn't have any compatible devices. After this configuration Stage passes, the user is not prompted again.

last_auth_threshold string

If any of the user's device has been used within this threshold, this stage will be skipped

webauthn_user_verification UserVerificationEnum (string)

Possible values: [required, preferred, discouraged]

webauthn_allowed_device_types uuid[]

webauthn_allowed_device_types_obj

object[]

required

Array [

aaguid uuidrequired

description stringrequired

]

Example (from schema)

{
  "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"
    }
  ],
  "not_configured_action": "skip",
  "device_classes": [
    "static"
  ],
  "configuration_stages": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ],
  "last_auth_threshold": "string",
  "webauthn_user_verification": "required",
  "webauthn_allowed_device_types": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ],
  "webauthn_allowed_device_types_obj": [
    {
      "aaguid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "description": "string"
    }
  ]
}

400

application/json

Schema

Schema

non_field_errors string[]
code string
property name* any

Validation Error

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 PATCH '/api/v3/stages/authenticator/validate/:stage_uuid/' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
  "name": "string",
  "flow_set": [
    {
      "name": "string",
      "slug": "string",
      "title": "string",
      "designation": "authentication",
      "policy_engine_mode": "all",
      "compatibility_mode": true,
      "layout": "stacked",
      "denied_action": "message_continue"
    }
  ],
  "not_configured_action": "skip",
  "device_classes": [
    "static"
  ],
  "configuration_stages": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ],
  "last_auth_threshold": "string",
  "webauthn_user_verification": "required",
  "webauthn_allowed_device_types": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}'

Request Collapse all

Base URL

/api/v3

Auth

Bearer Token

Parameters

stage_uuid — pathrequired

Body

{
  "name": "string",
  "flow_set": [
    {
      "name": "string",
      "slug": "string",
      "title": "string",
      "designation": "authentication",
      "policy_engine_mode": "all",
      "compatibility_mode": true,
      "layout": "stacked",
      "denied_action": "message_continue"
    }
  ],
  "not_configured_action": "skip",
  "device_classes": [
    "static"
  ],
  "configuration_stages": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ],
  "last_auth_threshold": "string",
  "webauthn_user_verification": "required",
  "webauthn_allowed_device_types": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}