Create a new agent

Create a new agent in the caller’s organization. The agent starts in draft status and private visibility. A service account is provisioned automatically; failure to provision rolls back the creation.

POST /v1/agents

Create a new agent

cURL

curl --request POST \
  --url https://{host}/v2/workspaces/slug:agent-factory/webhooks/v1/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "instructions": "You are a helpful test assistant."
}
'

200

{
  "id": "<string>",
  "name": "<string>",
  "status": "draft",
  "serviceAccountId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z"
}

Authorizations

BearerAuthOrgApiKeyAuth

Authorization · string · header · required

User-bound credential carrying an identity: either a session JWT or a user access token (at:*) generated from the user settings UI. Send as Authorization: Bearer <token>. Org API keys (iak_*) are not accepted here - they carry no user identity. Use the x-prismeai-api-key header instead (see OrgApiKeyAuth).

Body

application/json

instructions · string · required

System prompt / agent instructions.

Maximum string length: 100000

name · string

Maximum string length: 256

description · string

Maximum string length: 4096

model · string

Maximum string length: 128

fallback_models · string[]

temperature · number

profile · enum<string>

Available options: simple, workflow, agent_light, agent_full, orchestrator

Maximum string length: 64

skills · object[]

sub_agents · object[]

Sub-agent delegations (max 20).

Hide child attributes

sub_agents. agent_id · string

sub_agents. name · string

sub_agents. description · string

starters · object[]

Conversation starter prompts (max 10).

Response

200

application/json

Agent created.

Slim record returned on agent create / import.

id · string

name · string

status · enum<string>

Available options: draft

serviceAccountId · string

createdAt · string<date-time>