Serialize Identity Verification Context Action

Returns a JSON array of identity verification field descriptors that an Agentforce agent uses to collect caller answers.

This action is available in API version 68.0 and later.

Supported REST HTTP Methods 

URI: /services/data/vXX.X/actions/standard/serializeVerificationContext

Where XX.X is the latest API version.

Formats: JSON, XML

HTTP Methods: POST

Authentication: Authorization: Bearer TOKEN

Where TOKEN is your OAuth access token.

Inputs 

InputTypeDescription
verificationContextReferenceRequired
An Apex id_verification__VerificationContext record that represents the active identity verification session.

Outputs 

OutputTypeDescription
verificationFieldsArrayA JSON array of verification field descriptors with empty answer placeholders. For example, [{"label":"Date of Birth","answer":"","developerName":"Birthdate_Field"}]. The agent populates each answer and passes the array as callerAnswers to the Identity Verification flow.

Example 

Sample Request

1{
2        "inputs": [
3        {
4        "verificationContext": {
5        "processDefinition": {
6        "developerName": "StandardIdentityVerification"
7        }
8        }
9        }
10        ]
11        }

Sample Response

1[
2        {
3        "verificationFields": [
4        {
5        "label": "Date of Birth",
6        "answer": "",
7        "developerName": "Birthdate_Field"
8        },
9        {
10        "label": "ZIP Code",
11        "answer": "",
12        "developerName": "ZipCode_Field"
13        }
14        ]
15        }
16        ]