Agents

Admit a ComputeID passport agent

Requires an organization API key with agents:manage. The signed receipt is passed through and verified offline. Requested passport scopes remain subject to the provider allowlist and caller delegation ceiling. Returns the raw agent key once.

post/agents/computeid/admit

Request

  • Base URL: https://app.arkova.ai/api/v1
  • URL: https://app.arkova.ai/api/v1/agents/computeid/admit
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Request body

passport_idstring uuid required
namestring
descriptionstring
allowed_scopesstring[]

The runtime accepts known API scopes, drops scopes outside the seven-scope passport allowlist, and denies any explicitly requested passport scope above the caller ceiling.

Response

Passport bound and raw key returned once

keystring required

Returned once and never persisted raw.

key_idstring uuid required
key_prefixstring required
scopesstring[] required
warningstring required

Changes

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