# Attria API

> REST API and MCP server for Attria — Studio (websites, documents, apps, images, video), Agents and Objects. Everything a key does lands in its owner's workspace and is billed in credits.

- Base URL: https://app.attria.io/api — auth with `Authorization: Bearer attria_sk_…` (Settings → API).
- Errors are always `{ "error": { "type", "message", "details?" }, "request_id" }`.
- Send `Idempotency-Key` on writes. Studio turns take `auto`, `stream` and `background`; agents should send `auto: true` and `background: true`, then poll.
- MCP (Streamable HTTP, same key): https://app.attria.io/api/v1/mcp

## Docs

- [Guide for agents](https://app.attria.io/api/v1/llms-full.txt): auth, turns, polling, idempotency, errors, and every endpoint with an example
- [OpenAPI 3.1 spec](https://app.attria.io/api/v1/openapi.json): machine-readable schema of every endpoint

## Studio

- [Talk to the Website Director — build or change a website](https://app.attria.io/api/v1/llms-full.txt#studio_website_turn): `POST /v1/studio/website/turns` (tool `studio_website_turn`), slow
- [Talk to the Documents director — write or change a deck, proposal or document](https://app.attria.io/api/v1/llms-full.txt#studio_document_turn): `POST /v1/studio/document/turns` (tool `studio_document_turn`), slow
- [Talk to the App Builder — build or change a workspace app](https://app.attria.io/api/v1/llms-full.txt#studio_app_turn): `POST /v1/studio/app/turns` (tool `studio_app_turn`), slow
- [Talk to the Images director — make images on a board](https://app.attria.io/api/v1/llms-full.txt#studio_image_turn): `POST /v1/studio/image/turns` (tool `studio_image_turn`), slow
- [Talk to the Video director — edit a video project](https://app.attria.io/api/v1/llms-full.txt#studio_video_turn): `POST /v1/studio/video/turns` (tool `studio_video_turn`), slow
- [Get a Studio turn](https://app.attria.io/api/v1/llms-full.txt#studio_turn_get): `GET /v1/turns/{id}` (tool `studio_turn_get`)
- [List the Studio's Content Apps](https://app.attria.io/api/v1/llms-full.txt#studio_apps_list): `GET /v1/studio/apps` (tool `studio_apps_list`)
- [Run a Studio Content App](https://app.attria.io/api/v1/llms-full.txt#studio_app_run): `POST /v1/studio/{studio}/apps/{app}` (tool `studio_app_run`), slow
- [List websites](https://app.attria.io/api/v1/llms-full.txt#websites_list): `GET /v1/websites` (tool `websites_list`)
- [Get a website and its build](https://app.attria.io/api/v1/llms-full.txt#websites_get): `GET /v1/websites/{id}` (tool `websites_get`)
- [List documents](https://app.attria.io/api/v1/llms-full.txt#documents_list): `GET /v1/documents` (tool `documents_list`)
- [Get a document with its full content](https://app.attria.io/api/v1/llms-full.txt#documents_get): `GET /v1/documents/{id}` (tool `documents_get`)
- [List apps](https://app.attria.io/api/v1/llms-full.txt#apps_list): `GET /v1/apps` (tool `apps_list`)
- [Get an app](https://app.attria.io/api/v1/llms-full.txt#apps_get): `GET /v1/apps/{id}` (tool `apps_get`)
- [List image boards](https://app.attria.io/api/v1/llms-full.txt#images_boards_list): `GET /v1/images/boards` (tool `images_boards_list`)
- [List images](https://app.attria.io/api/v1/llms-full.txt#images_list): `GET /v1/images` (tool `images_list`)
- [List video projects](https://app.attria.io/api/v1/llms-full.txt#videos_list): `GET /v1/videos` (tool `videos_list`)

## Agents

- [List Agents](https://app.attria.io/api/v1/llms-full.txt#agents_list): `GET /v1/agents` (tool `agents_list`)
- [Create an Agent from a description](https://app.attria.io/api/v1/llms-full.txt#agents_create): `POST /v1/agents` (tool `agents_create`), slow
- [Get an Agent](https://app.attria.io/api/v1/llms-full.txt#agents_get): `GET /v1/agents/{id}` (tool `agents_get`)
- [Change an Agent](https://app.attria.io/api/v1/llms-full.txt#agents_update): `PATCH /v1/agents/{id}` (tool `agents_update`), slow
- [Turn an Agent on](https://app.attria.io/api/v1/llms-full.txt#agents_activate): `POST /v1/agents/{id}/activate` (tool `agents_activate`), slow
- [Pause an Agent](https://app.attria.io/api/v1/llms-full.txt#agents_pause): `POST /v1/agents/{id}/pause` (tool `agents_pause`)
- [Talk to an Agent (run it)](https://app.attria.io/api/v1/llms-full.txt#agents_runs_create): `POST /v1/agents/{id}/runs` (tool `agents_runs_create`), slow
- [List an Agent's runs](https://app.attria.io/api/v1/llms-full.txt#agents_runs_list): `GET /v1/agents/{id}/runs` (tool `agents_runs_list`)
- [Get a run with its steps](https://app.attria.io/api/v1/llms-full.txt#runs_get): `GET /v1/runs/{id}` (tool `runs_get`)
- [List approvals](https://app.attria.io/api/v1/llms-full.txt#approvals_list): `GET /v1/approvals` (tool `approvals_list`)
- [Approve or reject an Agent action](https://app.attria.io/api/v1/llms-full.txt#approvals_decide): `POST /v1/approvals/{id}` (tool `approvals_decide`), slow

## Objects

- [List Objects](https://app.attria.io/api/v1/llms-full.txt#objects_list): `GET /v1/objects` (tool `objects_list`)
- [Create an Object](https://app.attria.io/api/v1/llms-full.txt#objects_create): `POST /v1/objects` (tool `objects_create`)
- [Get an Object](https://app.attria.io/api/v1/llms-full.txt#objects_get): `GET /v1/objects/{object}` (tool `objects_get`)
- [Change an Object](https://app.attria.io/api/v1/llms-full.txt#objects_update): `PATCH /v1/objects/{object}` (tool `objects_update`)
- [List and query records](https://app.attria.io/api/v1/llms-full.txt#objects_records_list): `GET /v1/objects/{object}/records` (tool `objects_records_list`)
- [Create a record](https://app.attria.io/api/v1/llms-full.txt#objects_records_create): `POST /v1/objects/{object}/records` (tool `objects_records_create`)
- [Get a record](https://app.attria.io/api/v1/llms-full.txt#objects_records_get): `GET /v1/objects/{object}/records/{id}` (tool `objects_records_get`)
- [Update a record](https://app.attria.io/api/v1/llms-full.txt#objects_records_update): `PATCH /v1/objects/{object}/records/{id}` (tool `objects_records_update`)
- [Delete a record](https://app.attria.io/api/v1/llms-full.txt#objects_records_delete): `DELETE /v1/objects/{object}/records/{id}` (tool `objects_records_delete`)
- [List a record's relationships](https://app.attria.io/api/v1/llms-full.txt#objects_relationships_list): `GET /v1/objects/{object}/records/{id}/relationships` (tool `objects_relationships_list`)
- [Link a record to another](https://app.attria.io/api/v1/llms-full.txt#objects_relationships_create): `POST /v1/objects/{object}/records/{id}/relationships` (tool `objects_relationships_create`)

## Account

- [Who this key acts as](https://app.attria.io/api/v1/llms-full.txt#account_me): `GET /v1/me` (tool `account_me`)