Skip to main content
POST
Create an agent

Authorizations

Authorization
string
header
required

A Skydive API key, sent as Authorization: Bearer sky_live_.... Keys are scoped to a single agent and carry a use or edit scope. The full key value is shown once at creation and never again.

Body

application/json
name
string
required

Display name for the new agent.

Required string length: 1 - 120
Example:

"Support Bot"

model
string | null

Optional model id to run the agent on. Omit to use your workspace default.

Maximum string length: 120

Response

The agent was created.

agent
object
required