POST/api/agentsbearer token

Create an agent

Creates an agent with sensible defaults for anything you leave out, so a name and a role are enough to get something that works.

Try it

curl -X POST "https://storkie.ai/api/agents" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Support bot","role":"Answers product questions"}'

No Run button: this needs your bearer token, and a docs page that asks for one is teaching people to paste credentials into web forms.

Request body

Name	Type	Description
`name`required	string	Display name.
`role`	string	What it does, in a sentence.
`useCase`	string	Preset to start from.

Response

Name	Type	Description
`agent`required	object	The created agent, including its `id`.

Rate limit

40 requests / minute / account

Errors

400 — Missing `name`.
401 — Missing or invalid token.
429 — Rate limited.

Other endpoints

POST/api/agents/chat

Chat with an agent

GET/api/agents/public

Read an agent’s public profile

GET/api/agents/data

Read an agent’s published datasets

GET/api/agents

List your agents