Agents

Create an agent identity

Changed on
post/api/v1/agents

Request

  • Base URL: http://localhost:8081
  • URL: http://localhost:8081/api/v1/agents
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Headers

X-Tenant-IDstring required

Tenant isolation header (required on all protected routes).

Request body

namestring required
descriptionstring
ownerstring required
teamstring
risk_tierstring required
allowed_topicsstring[]
allowed_poolsstring[]
allowed_serversstring[]

MCP server-name glob allowlist. Empty or omitted fail-closes server-guarded MCP actions.

allowed_toolsstring[]
allowed_resourcesstring[]

cordum:// resource URI glob allowlist. Empty or omitted fail-closes resource-guarded MCP actions.

entitlementsstring[]

Capability tokens the identity holds for MCP required-entitlement checks.

preapproved_mutating_toolsstring[]

Mutating MCP tool names/globs this identity may call without human approval. Empty or omitted requires approval for every mutating tool.

data_classificationsstring[]

Response

Agent identity created

object required

Changes

  • 12120aad0bfeRevision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • b2c6863309beRevision changes
    • info

      endpoint added