Skip to main content
POST
Create Agent

Overview

Creates an agent and its three environments (dev, staging, production) in one step. The environments start unpinned; save a version with Create Agent Version and promote it to pin one. To build an agent from the dashboard instead, see Build your first agent. Requires an admin, owner, operator, or prompter role.

Headers

string
required
Your API key for authentication.

Body Parameters

string
required
Display name for the agent. Must be non-empty after trimming whitespace. Returns 400 INVALID_NAME otherwise.

Response

Returns 201 on success.
object
The new agent.
array
The agent’s three environments, all unpinned.
null | array
null on success, or a list of error objects if the request failed.

Docs for agents: llms.txt