Skip to main content
GET
/
v1
/
agents
/
{id}
Get agent by id
curl --request GET \
  --url https://api.conduit.ai/v1/agents/{id} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "id": "ag77c0dy0mgdpzmqz6tesry8w184002s",
    "workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
    "name": "Reservations",
    "description": "Handles booking and cancellation flows.",
    "version": "v2",
    "instructions": "Answer booking questions, use policies before escalating, and keep replies concise.",
    "guardrails": [
      {
        "id": "guardrail_1",
        "title": "Do not promise refunds",
        "knowledge": "Only cite refund terms from approved policy docs or escalate."
      }
    ],
    "operation_mode": "autopilot",
    "autopilot_schedule": null,
    "custom_response_delay_ms": 10000,
    "auto_mark_as_done": false,
    "response_language": "English",
    "responseflow": true,
    "output_schema": [
      {
        "name": "resolution",
        "description": "Short summary of the final outcome.",
        "type": "string",
        "is_required": true
      }
    ],
    "skill_ids": [
      "ks77c0dy0mgdpzmqz6tesry8w184002s"
    ],
    "enabled": true,
    "triggers": [
      {
        "id": "tr77c0dy0mgdpzmqz6tesry8w184002s",
        "workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
        "name": "Reservation Inbox",
        "description": "Runs for reservation inbox messages.",
        "type": "message",
        "config": {
          "inboxTypeId": "guest",
          "channels": [
            "unthreaded_email"
          ]
        },
        "enabled": true,
        "created_at": "2026-04-01T17:22:10.000Z",
        "updated_at": "2026-04-03T03:14:15.000Z"
      }
    ],
    "created_at": "2026-04-01T17:22:10.000Z",
    "updated_at": "2026-04-03T03:14:15.000Z"
  }
}

Authorizations

Authorization
string
header
required

Conduit API token. Use Authorization: Bearer <token>. Read/write endpoints require a token with write access.

Path Parameters

id
string
required

Agent id.

Example:

"ag77c0dy0mgdpzmqz6tesry8w184002s"

Query Parameters

workspace_id
string

Optional workspace override. If omitted, Conduit resolves the agent's workspace automatically.

Example:

"j57demo8f8x7c9v0n2q4r6t8y1u3i5o"

Response

Agent

Single V2 chat agent response.

data
object
required