post/provisioning-requests

Request

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

Request body

resource'VAULT' | 'PHONE_NUMBER' required

Resource being requested: VAULT (encrypted secret storage for this agent) or PHONE_NUMBER (a provisioned number, Starter+ only).

reasonstring required

Why the agent needs this, shown verbatim to the owner. Required — an unexplained ask is not a decidable one.

Response

OK

requestIdstring required

Unique provisioning request identifier

agentIdstring required

Agent the resource would belong to

agentNamestring required

Agent display name, so the owner knows who is asking

resource'VAULT' | 'PHONE_NUMBER' | 'GENERIC' required

Resource being requested: VAULT (encrypted secret storage for this agent), PHONE_NUMBER (a provisioned number, Starter+ only), or GENERIC (a master-gated operation the agent tried to perform; approving grants permission rather than provisioning anything).

reasonstring required

The agent's stated justification

status'PENDING' | 'APPROVED' | 'DECLINED' | 'EXPIRED' | 'CANCELLED' required

Lifecycle status: PENDING (awaiting the owner), APPROVED (resource provisioned), DECLINED (owner refused — soft, the agent may ask again), EXPIRED (7-day TTL elapsed unanswered), CANCELLED (withdrawn by the agent).

expiresAtstring date-time required

When an unanswered request stops being actionable

decidedAtstring date-time nullable required

When the owner decided; null while PENDING

decidedNotestring nullable required

The owner's note, typically the reason for a decline — surfaced so a second attempt can address the objection instead of repeating the first

provisionedIdstring nullable required

Id of what approval created (vault identity or phone identity); null unless APPROVED

createdAtstring date-time required

When the agent asked

emailSentboolean required

Whether the owner was successfully emailed. False means the request is still live and visible in the console — the notification failed, not the request.

Changes

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