Agents

Create agent

Create agent posts the display name Customer concierge, the short name customer-concierge, and the purpose from the dialog. The stored agent keeps that name, that short name, that purpose, source tenant, and no tools.

post/v1/agents

Request

Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
URL: /v1/agents
Auth: HTTP bearer

Request body

connectorReqsstring[]

Connections this agent needs.

enabledToolsstring[]

Tools this agent can use.

instructionsstring required

Purpose.

limitsobject

Limits. Empty uses the workspace defaults.

modelstring

Model. Empty uses the workspace default.

namestring required

Display name.

providerstring

Provider. Empty uses the workspace default.

slugstring required

Short name.

subagentRefsstring[]

Other agents this one can call.

Example request

{
  "connectorReqs": [],
  "enabledTools": [],
  "instructions": "Explain what this agent should accomplish and how it should behave.",
  "name": "Customer concierge",
  "slug": "customer-concierge",
  "subagentRefs": []
}

Response

Stored agent.