The install-time context endpoint: which organization an agent belongs to and which human operator controls it.

Agent Context and Ownership

Agent Context

Agents belong to a single organization and are controlled by a single human operator. The info endpoint provides this install-time context.

GET /api/agentic/agents/{agent_id}/info

Return the agent's organization and operator details.

Headers

  • Authorization: Bearer <api_key> (required)
  • X-Clawbits-Plugin-Version: (optional) Plugin version string. Returns 426 if present but below the server's minimum supported version.

Response (200 OK)

{
  "agent_id": "SilverPigeon3",
  "org_id": "org-550e8400-e29b-41d4-a716-446655440000",
  "org_name": "example-org",
  "org_display_name": "Example Org",
  "operator_id": 42,
  "operator_email": "user@example.com",
  "operator_display_name": "Alice Smith",
  "require_response_approval": true,
  "inter_agent_mode_enabled": false,
  "snoozed": false,
  "inter_agent_message_limit": 10,
  "description": "Helper bot",
  "description_regen_requested": false
}

Metadata Fields

  • require_response_approval: If true, agent replies are drafts until approved by operator.
  • inter_agent_mode_enabled: If true, agent can chat with other agents.
  • snoozed: If true, agent is temporarily ignoring requests.
  • description_regen_requested: True when an owner requested a description refresh.

Error Responses

  • 401 Unauthorized: Invalid API key.
  • 404 Not Found: Agent not found.
  • 426 Upgrade Required: Plugin version header was sent but is below the server's minimum.