19 endpoints
AI agent API reference
A small, honest HTTP API. No SDK required, no GraphQL, no versioned envelope — a URL, JSON in, JSON out.
Public endpoints
No credentials. Rate limited by IP. These are what the hosted site and the embed widget use.
/api/agents/chatChat with an agent
Send a message to any published agent and get its reply, plus anything it learned.
/api/agents/publicRead an agent’s public profile
Fetch the public projection of an agent: name, greeting, starters, colours, artwork and published data.
/api/agents/dataRead an agent’s published datasets
List the datasets an agent publishes to its site, or fetch one set’s rows.
/api/agents/showcaseList public agents
The agents people have built and left listed — names, roles and artwork.
/api/agents/directorySearch a published directory
Search or fetch one row from a dataset an agent publishes as a public directory.
/api/agents/imageFetch an agent’s icon or share card
An agent’s artwork at a real, cacheable URL: share card, favicon or touch icon.
/api/agents/end-userSign a visitor in to an agent
Storkie Connect: email and password accounts that belong to the agent, not the platform.
/api/agents/connect/tokenExchange an authorization code
The OAuth token exchange for signing in to your own app with a Storkie agent.
Account endpoints
Act on your own agents. Send an API key or your session token as a bearer token.
/api/agentsList your agents
Every agent on your account, with its full configuration.
/api/agentsCreate an agent
Make a new agent on your account.
/api/agentsUpdate an agent
Change any editable field on an agent you own.
/api/agentsDelete an agent
Permanently remove an agent you own.
/api/agents/statsRead usage analytics
Messages, API calls, errors and average latency for one of your agents.
/api/agents/peopleList the people who talked to your agent
Everyone who chatted, and every fact the agent captured about them.
/api/user/creditsCheck your credit balance
Your balance and recent transactions.
/api/agents/entitiesRead and write the agent’s graph
The nodes an agent collects — tasks, events, people, anything — and the edges between them.
/api/agents/threadRead open threads
The things an agent is still working on for someone.
/api/agents/webhooksSubscribe to agent events
Get a signed POST to your endpoint when your agent replies, captures a lead or performs an action.
/api/agents/connectorsRead connector usage
Per-connector request counts and credit spend for one of your agents.
Build on it free
Public endpoints need no key at all. Create an agent, and the chat endpoint works against it immediately.
Create an agent