DKBSignDocs

API reference

POSTRequires Bearer token

Create a signed-document share link

/api/v4/documents/{uuid}/share

Submit /api/v4/documents/{uuid}/share. Authenticated routes need Authorization: Bearer {token} from POST /api/v1/login.

Path parameters

FieldTypeDescription
uuid
Required
stringPath parameter uuid.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
expires_in
integerTTL in seconds (60–604800, default 3600).
e.g. 3600

Responses

StatusMeaning
200Share link
401Missing or invalid Bearer token.

Request

curl
curl -X POST 'https://api.dkbsigns.com/api/v4/documents/550e8400-e29b-41d4-a716-446655440000/share' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"expires_in":3600}'

Response 200

json
{
  "share_url": "https://api.dkbsigns.com/api/v4/documents/550e8400-e29b-41d4-a716-446655440000/download?expires=1770000000&sig=…",
  "expires_at": "2026-03-01T11:00:00Z",
  "expires_in": 3600,
  "document_uuid": "550e8400-e29b-41d4-a716-446655440000"
}