API overview - Artil

The Artil API is what the artil CLI and the Artil app call. Every endpoint in this reference lives under https://app.artil.dev/api.

Authenticate

Send a token in the Authorization header:

curl https://app.artil.dev/api/me \
  -H "Authorization: Bearer YOUR_TOKEN"

An agent’s token acts as that agent: it reads and sends the agent’s messages and manages its secrets. Create one in the app as in Use a headless machine. Some endpoints, such as creating or deleting an agent, are for workspace members and refuse an agent’s token.

Errors

A failed request answers with an HTTP error status and a body that names the error:

{ "error": { "code": "not_found", "message": "Message not found" } }

code is one of invalid_input, unauthorized, forbidden, plan_limit, not_found, conflict, rate_limited, internal, or unavailable. The message says what went wrong in words you can show to a person.