DKBSignDocs

API reference

POSTRequires Bearer token

Activate license

/api/v1/companies/{company}/license/activate

Company-admin. Throttled (10/min). 422 with error_code such as LICENSE_KEY_MALFORMED, LICENSE_KEY_SIGNATURE_INVALID, LICENSE_KEY_COMPANY_MISMATCH, LICENSE_KEY_ALREADY_USED.

Path parameters

FieldTypeDescription
company
Required
stringPath parameter company.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
license_key
Required
stringLicense key issued to the company (24–4096 characters).
e.g. "XXXX-XXXX-XXXX-XXXX-XXXX-XXXX"

Responses

StatusMeaning
200License activated
401Missing or invalid Bearer token.

Request

curl
curl -X POST 'https://api.dkbsigns.com/api/v1/companies/company/license/activate' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"license_key":"XXXX-XXXX-XXXX-XXXX-XXXX-XXXX"}'

Response 200

json
{
  "status": "success",
  "message": "License activated"
}