DKBSignDocs

API reference

PUTRequires Bearer token

Update retention settings

/api/logs-audit/retention

Update /api/logs-audit/retention. Authenticated routes need Authorization: Bearer {token} from POST /api/v1/login.

Path parameters

This endpoint has no path parameters.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
retention_years
integerRetention period.
e.g. 7
auto_archive
booleanArchive automatically.
e.g. true
worm_storage
booleanWrite-once storage.
e.g. false
hash_chaining
booleanHash-chain events.
e.g. true
qualified_timestamp
booleanStamp the chain with a qualified TSA.
e.g. false

Responses

StatusMeaning
200Retention
401Missing or invalid Bearer token.

Request

curl
curl -X PUT 'https://api.dkbsigns.com/api/logs-audit/retention' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"retention_years":7,"auto_archive":true,"worm_storage":false,"hash_chaining":true,"qualified_timestamp":false}'

Response 200

json
{
  "org_id": "1",
  "retention_years": 7,
  "hash_chaining": true,
  "events_count": 12000
}