post/agent/elevate

Request

  • Base URL: https://api.useanima.sh/v1
  • URL: https://api.useanima.sh/v1/agent/elevate
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

otp_codestring

The 6-digit code emailed to the owner by /agent/elevate/request

grantstring

An owner grant from a previous enrolment, used instead of an emailed code. The caller is expected to have kept it behind a local human-presence gate.

enrollboolean

Also return a durable owner grant, so later step-ups on this machine need no email. Honoured only when authorising with otp_code — a grant cannot mint its successor.

Response

OK

api_keystring required

Short-lived key with master capability. Shown once; store it now.

expires_atstring date-time required

When the key stops working

api_key_idstring required

Id of the issued key, for revoking it early

grantstring

Durable owner grant. Shown once; store it behind a human-presence gate.

grant_expires_atstring date-time

When the grant stops being accepted and an emailed code is needed again

Changes

No recorded changes to this operation across all 1 revision of this API.