Request retention extension

Requires explicit protection token permission. Cannot shorten existing or configured minimum retention.

POST/api/archive/{id}/retention

Request retention extension

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

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",
  "retainUntil": "2024-08-23T00:00:00+00:00"
}

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