Admit a disposition request

Requires explicit disposition token permission and enabled reviewed copy/backup policy. Checks current revision, retention, holds, pending operations and all copies. 202 follows protected admission; background deletion starts separately.

POST/api/archive/{id}/disposition

Admit a disposition request

curl --request POST \
  --url 'https://app.output.rocks/api/archive/123/disposition' \
  --header 'X-AUTH-TOKEN: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "expectedRevision": 1,
  "reason": "string",
  "idempotencyKey": "string"
}'

202

application/json

{
  "operationId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "pending",
  "revision": 1,
  "expectedRevision": 1,
  "attempts": 1,
  "error": "string",
  "kind": "string",
  "certificate": {}
}

Authorizations

X-AUTH-TOKEN

stringheaderrequired

Value for the X-AUTH-TOKEN header parameter.

Path Parameters

integerrequired

No description provided.

Header Parameters

Idempotency-Key

string

Required here or as idempotencyKey in the body. Both, if given, must agree. Changed inputs conflict.

Request Body

application/json

required

{
  "expectedRevision": 1,
  "reason": "string",
  "idempotencyKey": "string"
}

Response

202application/json

Durably accepted; follow Location until confirmed.

operationId

string<uuid>required

status

enum<string>required

Available options: pendingadmittedconfirmed

revision

integer

expectedRevision

integer

attempts

integer

error

string | null

kind

string

certificate

object | null