DKBSignDocs

API reference

POSTRequires Bearer token

Validator summary

/api/ai/documents/{document_id}/validator-summary

Shorter summary for a workflow validator: a_valider, points_attention, elements_a_confirmer, resume_contextuel.

Path parameters

FieldTypeDescription
document_id
Required
stringPath parameter document_id.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
step
Required
stringWorkflow step name.
e.g. "Legal review"
role
Required
stringActor role.
e.g. "validator"
actor_name
stringOptional actor display name.
e.g. "Ada Kouassi"
focus
arrayOptional focus topics.

Responses

StatusMeaning
200Validator summary
401Missing or invalid Bearer token.

Request

curl
curl -X POST 'https://api.dkbsigns.com/api/ai/documents/uuid_or_id/validator-summary' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"step":"Legal review","role":"validator","actor_name":"Ada Kouassi"}'

Response 200

json
{
  "result": {
    "a_valider": [],
    "points_attention": [],
    "resume_contextuel": "…"
  }
}