Contract Revisions
Initiate Signature Challenge
Initiates a challenge for a specific signature slot of a specific contract revision.
post/api/agreement/v1/contract-revisions/{id}/signatures/{slotCode}/otp-challenges
Path parameters
idstring uuid required
slotCode'DATA_CONSUMER_01' | 'DATA_CONSUMER_02' | 'DATA_PROVIDER_01' | 'DATA_PROVIDER_02' required
Query parameters
actingRole'CONSUMER' | 'PROVIDER'
Selects the role in which the authenticated user acts for this request. Optional: if the authenticated user holds exactly one of the allowed roles, the value is auto-resolved. Returns 400 if the value is unknown, not allowed for this endpoint, or omitted while the user holds multiple matching roles. Returns 403 if the user does not hold the role specified in the parameter.
Response
OK
Example response
{
"expiresAt": "2022-03-10T12:15:50",
"maskedPhoneNumber": "***********8",
"retryAfterSeconds": 30
}