/v1/keys/{custodian}/{epoch}/declare-lost

POST

const url = 'https://api.reindeer.example.tr/v1/keys/primary/1/declare-lost';
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.reindeer.example.tr/v1/keys/primary/1/declare-lost \
  --header 'Authorization: Bearer <token>'

Scope keys:admin, fresh step-up. Only for keys the custodian reports missing; needs an approver.

Authorizations

mutualTLS
session

Parameters

Path Parameters

custodian

required

string

Allowed values: primary dr

epoch

required

integer

Responses

202

Approval waiting for a second person

application/json

object

approval

object

string

kind

string

Allowed values: identity.create invite.create export.full deletion.accept key.declare-lost

summary

string

requested_by

string

requested_at

string format: date-time

not_before

string format: date-time

expires_at

string format: date-time

state

string

Allowed values: pending approved executing rejected expired executed failed cancelled

controllers

Everyone who controlled the requester when the request was made: the issuers of its codes, the person who requested a machine, and their controllers in turn

Array<string>

cool_off_seconds

integer

decided_by

string

decided_at

string format: date-time

cancelled_by

string

cancelled_at

string format: date-time

result

object

Example

{
  "approval": {
    "kind": "identity.create",
    "state": "pending"
  }
}