Introduction
API reference
40 endpoints in 4 sections, generated from the OpenAPI spec the API itself is built from (a checked-in snapshot of it). Version 1.0.0.
Base URL
https://app.attria.io/apiAuthentication
Authorization: Bearer attria_sk_…Machine-readable
openapi.json · llms.txtStudioMake and edit websites, documents, apps, images and video by talking to the same Studio director the product uses. Each message is a turn.
- POST
/v1/studio/website/turnsTalk to the Website Director - POST
/v1/studio/document/turnsTalk to the Documents director - POST
/v1/studio/app/turnsTalk to the App Builder - POST
/v1/studio/image/turnsTalk to the Images director - POST
/v1/studio/video/turnsTalk to the Video director - GET
/v1/turns/{id}Get a Studio turn - GET
/v1/studio/appsList the Studio's Content Apps - POST
/v1/studio/{studio}/apps/{app}Run a Studio Content App - GET
/v1/websitesList websites - GET
/v1/websites/{id}Get a website and its build - GET
/v1/documentsList documents - GET
/v1/documents/{id}Get a document with its full content - GET
/v1/appsList apps - GET
/v1/apps/{id}Get an app - GET
/v1/images/boardsList image boards - GET
/v1/imagesList images - GET
/v1/videosList video projects
AgentsList, create, update and run the workspace's agents; follow their runs, steps and approvals.
- GET
/v1/agentsList Agents - POST
/v1/agentsCreate an Agent from a description - GET
/v1/agents/{id}Get an Agent - PATCH
/v1/agents/{id}Change an Agent - POST
/v1/agents/{id}/activateTurn an Agent on - POST
/v1/agents/{id}/pausePause an Agent - GET
/v1/agents/{id}/runsList an Agent's runs - POST
/v1/agents/{id}/runsTalk to an Agent (run it) - GET
/v1/runs/{id}Get a run with its steps - GET
/v1/approvalsList approvals - POST
/v1/approvals/{id}Approve or reject an Agent action
ObjectsThe workspace's objects: definitions, records, queries and relationships.
- GET
/v1/objectsList Objects - POST
/v1/objectsCreate an Object - GET
/v1/objects/{object}Get an Object - PATCH
/v1/objects/{object}Change an Object - GET
/v1/objects/{object}/recordsList and query records - POST
/v1/objects/{object}/recordsCreate a record - GET
/v1/objects/{object}/records/{id}Get a record - PATCH
/v1/objects/{object}/records/{id}Update a record - del
/v1/objects/{object}/records/{id}Delete a record - GET
/v1/objects/{object}/records/{id}/relationshipsList a record's relationships - POST
/v1/objects/{object}/records/{id}/relationshipsLink a record to another
AccountWho a key acts as, the workspace it reaches, and what the account can use.
Every endpoint is also in the left nav. Writes send an Idempotency-Key; Studio turns are where most integrations start.