Getting started
Authentication
Bearer keys, workspaces, and per-client isolation for agencies running many accounts.
Every request carries a bearer key in the Authorization header. Keys are scoped to a workspace, and a workspace can contain many client projects.
Authorization: Bearer sk_live_9f3c21ab...
Content-Type: application/jsonAgencies: one account, many clients
Create a project per client. Prompts, runs, results and usage roll up per project, so you can bill a client for exactly what they consumed and you never have to log in forty times.
- Project-scoped keys can only read and write within one project.
- Workspace keys can create projects and read aggregate usage.
- Results are never shared across projects.
Rotate on offboarding
If you hand a project key to a client's in-house team, rotate it the day the retainer ends. Rotation is instant and does not affect other projects.