Agents

Register an agent

JWT callers must be organization admins. API keys require agents:manage and cannot delegate scopes they do not hold.

post/agents

Request

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

Request body

namestring required
descriptionstring
agent_type'llm_agent' | 'ats_integration' | 'hr_platform' | 'compliance_tool' | 'custom'
allowed_scopesstring[]
frameworkstring
versionstring
callback_urlstring uri
metadataobject

Metadata except the provider-managed computeid namespace.

Response

Agent registered

idstring uuid required
namestring required
descriptionstring nullable
agent_typestring required
status'active' | 'suspended' | 'revoked' required
allowed_scopesstring[] required
frameworkstring nullable
versionstring nullable
callback_urlstring uri nullable
metadataobject nullable
last_active_atstring date-time nullable

When an API key bound to this agent last authenticated (observed at authentication, throttled to about once a minute). Not a statement about what the request did.

Changes

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