Get an agent

get a single AI agent by id. Returns the same safe field set as the list endpoint.

GET https://api.centerfy.ai/webhooks/inbound/agents/:id

Headers

Header	Required	Value	Description
`x-api-key`	Yes	your sub-account API key (cfy_…)	Authenticates the request; or use Authorization: Bearer `<key>`.

Path parameters

Name	Type	Required	Description
`id`	`string (uuid)`	Yes	The agent id. A non-uuid returns 400; an agent that does not exist returns 404.

Example

curl -X GET "https://api.centerfy.ai/webhooks/inbound/agents/{id}" \
  -H "x-api-key: $CENTERFY_API_KEY"

import { CenterfyClient } from "@centerfy/sdk";

const centerfy = new CenterfyClient({ apiKey: process.env.CENTERFY_API_KEY! });

const result = await centerfy.agents.get("<agentId>");
console.log(result);

centerfy agents get <agentId>

MCP tool: centerfy_agents_get (see MCP server)

Response

{
  "status": "success",
  "agent": {
    "id": "b2c3d4e5-3333-4abc-9def-000000000030",
    "name": "Front Desk AI",
    "is_active": true
  }
}

Errors

401 — if unauthenticated; 400 for an invalid agent id; 404 if the agent does not exist; 500 on server error.

Notes

Read-only. Returns the same safe public projection as the list endpoint. The example agent fields are representative — the exact field set matches the list endpoint.