Arke
ReferenceSchemas

Agent

Reference for the arke/agent@v1 profile -- external AI services that process entities.

Profile

arke/agent@v1

Required Properties

PropertyTypeDescription
labelstringAgent display name
endpoint_urlstringURL that Arke calls to invoke the agent
capabilitiesstring[]List of capabilities the agent supports

Optional Properties

PropertyTypeDescription
descriptionstringWhat the agent does
statusstringactive / inactive / maintenance
supported_typesstring[]Entity types this agent can process
required_permissionsstring[]Permissions the agent needs
configobjectAgent-specific configuration

Relationships

PredicatePeer TypeDescription
api_key(internal)Bound API key entity
member_ofcollectionCollections the agent can access

Security

  • Agents authenticate with API keys (Authorization: ApiKey ak_xxxxx)
  • Arke signs outbound requests with Ed25519 (X-Arke-Signature)
  • Temporal permissions grant scoped, time-limited access per invocation

On this page