v1

latestOpenAPI 3.1.02026-07-266016.5 KB

Create Agent

Create a new agent for your organization.

post/agent

Request body

namestring required

Agent name

jsonContentobject required

Agent instructions as a structured document

mcpServersstring[]

MCP servers available to the agent

agentstring

Agent harness or model to use

Example request

{
  "name": "Daily triage",
  "jsonContent": {
    "type": "doc",
    "content": [
      {
        "type": "paragraph",
        "content": [
          {
            "type": "text",
            "text": "Review new issues and summarize priority, owner, and next steps."
          }
        ]
      }
    ]
  },
  "mcpServers": [
    "linear",
    "github"
  ],
  "agent": "claudeCode:claude-opus-4-5",
  "triggers": [
    {
      "name": "linear.issue.created"
    }
  ],
  "schedules": [
    {
      "cron": "0 9 * * 1-5"
    }
  ]
}

Response

Agent created successfully

idstring uuid required

Unique identifier for the agent

namestring required

Agent name

keystring nullable

Macro key generated for the agent

jsonContentobject nullable

Agent instructions as a structured document

agentstring nullable

Agent harness or model to use

mcpServersstring[]

MCP servers available to the agent

organizationIdstring uuid required

enabledAtstring date-time nullable

createdAtstring date-time required

updatedAtstring date-time required

Example response

{
  "name": "Daily triage",
  "key": "daily-triage",
  "agent": "claudeCode:claude-opus-4-5"
}

All 6 operations