DKBSignDocs

API reference

POSTPublic

Refuse a public envelope

/api/v4/public/envelopes/{signer_uuid}/refuse

Submit /api/v4/public/envelopes/{signer_uuid}/refuse. Authenticated routes need Authorization: Bearer {token} from POST /api/v1/login.

Path parameters

FieldTypeDescription
signer_uuid
Required
stringPath parameter signer_uuid.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
reason
stringOptional refusal reason.
e.g. "Incorrect party"
reason_code
stringOptional structured code. Currently seal_consent_declined.
e.g. "seal_consent_declined"

Responses

StatusMeaning
200Refused
401Missing or invalid Bearer token.

Request

curl
curl -X POST 'https://api.dkbsigns.com/api/v4/public/envelopes/550e8400-e29b-41d4-a716-446655440000/refuse' \
  -H 'Content-Type: application/json' \
  -d '{"reason":"Incorrect party","reason_code":"seal_consent_declined"}'

Response 200

json
{
  "message": "Signature refusée",
  "signer_status": "refused"
}