Skip to main content
POST/api/conversations/{conversationId}/headless/{next}

Send the information obtained from the user during the identity verification process

Takes the information from the user and calculates the next step that should be rendered to the user.

Detailed description of returned attributes:

ParameterExampleDescription
componentGLOBAL/ACCEPTEDName of method related with current step and expected action related to UI in verification process.
nextfd78cf43-12a7...Id of the page to which the user information should be submitted. Information is sent via the method POST /api/conversations/{conversationId}/headless/{next}.
argsparameter name listList of parameters that should be displayed to the user.
errorsmap with field name and error descriptionA map specifying incorrectly entered form fields and a description of the associated error.
errors.fieldparameter name sent in body attribute, validated and marked as incorrectValue specifying incorrectly entered form field.
errors.codeerror code related to the field described in errors.field attributeValue describing the error associated to the form field.

Parameters

NameInTypeRequiredDescription
conversationIdpathstringRequired

Conversation ID

nextpathstringRequired

Next step ID

X-User-IPheaderstringRequired

User IP Address

Request Body

Required
application/json
argsobject optional
[additional properties]string

Responses

200

Information available

application/vnd.authologic.v1.1+json
componentstring optional

Information needed to render the page

nextstring optional

Id of the page to which the user information should be submitted

argsobject optional

Option parameters which can be used by the user

[additional properties]any
errorsarray<object> optional

Information about errors occurred when processing the data from the page

Array of object

Information about errors occurred when processing the data from the page

fieldstring required
codestring required
400

Bad Request

application/vnd.authologic.v1.1+json
One of:
Variant 1
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

Variant 2
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

Variant 3
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

Variant 4
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

Variant 5
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

Variant 6
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

Variant 7
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

402

Exhaustion of the plan or limitations related to non-payment

403

Permission denied

application/vnd.authologic.v1.1+json
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

404

Conversation not found

application/vnd.authologic.v1.1+json
statusstring required

Response status

messagestring required

Descriptive error message

violationsarray<object> required

Validation error list

Array of object

Validation error list

fieldstring required

Field name

messagestring required

Descriptive error message

statusDetailstring optional

Response status detailed information

500

Server side error

Powered by Authologic Nisaba