# The Tarkovsky Studio API (0.72)

For agents, assistants and the people who build them: how to connect, the rules every call follows, the 26 tools and the 409 studio routes open to an agent, each with what it costs.

The same document for people: https://tarkovsky.ai/help/api.html

## Three ways in

An agent or assistant you connect works for you in your account. It does what the studio's own pages do, with the same checks and prices, one request at a time. There are three ways to call it, all behind the same key or sign-in.

| Way in | Address | For |
| --- | --- | --- |
| MCP | `https://tarkovsky.ai/mcp` | Assistants and agents that speak the Model Context Protocol (Streamable HTTP, JSON-RPC). They get the 26 tools below. |
| The tools over REST | `https://tarkovsky.ai/agent/v1/tools/<name>` | The same tools, one POST each, for a script or a backend. |
| The studio's routes (the door) | `https://tarkovsky.ai/agent/v1/api/<path>` and `https://tarkovsky.ai/agent/v1/media/{id}` | Every route the studio's page uses that is open to an agent: 409 of them, below. Files (a still, a take, a render) come from `/agent/v1/media/{id}`. An assistant with no shell calls them with the `studio_request` tool. |

| What | Address |
| --- | --- |
| This document, as Markdown | [https://tarkovsky.ai/help/api.md](https://tarkovsky.ai/help/api.md) |
| OpenAPI 3.1 (the tools and every route at the door) | [https://tarkovsky.ai/agent/v1/openapi.json](https://tarkovsky.ai/agent/v1/openapi.json) |
| The routes at the door, in short | [https://tarkovsky.ai/agent/v1/api.md](https://tarkovsky.ai/agent/v1/api.md) |
| The MCP server card | [https://tarkovsky.ai/.well-known/mcp/server-card.json](https://tarkovsky.ai/.well-known/mcp/server-card.json) |
| Who signs tokens in (RFC 9728) | [https://tarkovsky.ai/.well-known/oauth-protected-resource](https://tarkovsky.ai/.well-known/oauth-protected-resource) |
| The site, for language models | [https://tarkovsky.ai/llms.txt](https://tarkovsky.ai/llms.txt) |

## Connecting

### With an agent key

- Signed in to the studio, `POST /api/account/agent-links` with `{"name": "My agent", "budgetCredits": 50}` makes a key. The answer shows the key (`tk_…`) once: keep it. An account keeps at most 20 keys.
- Send it on every call as `Authorization: Bearer tk_…`.
- `GET /api/account/agent-links` lists your connections, what each has spent and which way each called in the last 30 days. `PUT /api/account/agent-links/{id}` changes a name or a budget; `DELETE /api/account/agent-links/{id}` revokes one at once. These are yours, in the studio: an agent can't call them.
- A key may carry the scopes below; without any it has `projects:read`, `projects:write`, `spend`.

```sh
claude mcp add --transport http tarkovsky https://tarkovsky.ai/mcp --header "Authorization: Bearer tk_…"
```

### With a sign-in (OAuth)

An MCP client that supports OAuth 2.1 with PKCE learns where to sign you in from `https://tarkovsky.ai/.well-known/oauth-protected-resource`, signs you in at the studio's sign-in page and asks for these scopes:

| Scope | What it allows |
| --- | --- |
| `projects:read` | Read the filmmaker's projects, their media and the catalogs. |
| `projects:write` | Change them as the studio's pages do: saves, locks, plans, choices. |
| `spend` | Hold credits for a paid call, within the connection's budget. |

Each connection, a key or a sign-in, has its own budget in credits: 200 unless you set another.

## The rules every call follows

- **It runs as the filmmaker.** Every request has the studio page's own checks, prices and guards. A refusal says why, as `{ "error": "…", "status": 403 }`.
- **The terms come first.** Until the account holder accepts the current Terms of Service and Privacy Notice in the studio, generations, purchases and agent calls are refused (403).
- **Money.** A route or tool is *free* (changes nothing that costs), a *quote* (free; nothing held) or *paid*. A paid call needs the `spend` scope (403 without it). Its credits are held before it runs and settled when it lands. A call whose most would pass the connection's budget is refused with 402, and nothing is held. Credits are bought in the studio, never through an agent.
- **Saves carry a revision.** Read a project (`GET /agent/v1/api/projects/{id}`) for its `revision` and send it with a save. A save from an older revision is refused with 409 ("Another session changed this project. Reload before saving."); read again and reapply. A locked draft refuses changes to its script (409) until a new draft is opened.
- **Retries are safe with an Idempotency-Key.** A write with an `Idempotency-Key` header (at most 120 characters) answers a retry with its first JSON answer and the header `Idempotent-Replayed: true`, instead of running again.
- **Nothing is deleted.** Every DELETE at the door is refused; deleting is the filmmaker's, in the studio. So are buying credits, sharing, publishing to the Gallery, confirming the rights to a picture and answering a flag (the full list is below).
- **Limits.** 120 calls a minute on a token; past it, 429 with `RateLimit` headers, then try again.
- **The caller's cookies never pass, and no cookie comes back.** Bodies are JSON as the page sends them; an upload's bytes pass as they are.

| Status | Means |
| --- | --- |
| 200, 201 | Done. The studio's answer, as its page gets it. |
| 400 | The body isn't what the route takes. The error names the field. |
| 401 | No key or token, or a revoked or expired one. |
| 402 | Past the connection's budget. Nothing was held. |
| 403 | Refused: the filmmaker's own, a missing scope, the terms not yet accepted, or the studio's own rule. The error says which. |
| 404 | No such project, file or route. A route the door doesn't know names this page. |
| 409 | A stale revision, a locked draft, or an Idempotency-Key still running or used for another request. |
| 429 | More than 120 calls a minute on the token. |
| 502 | The studio call didn't complete. Try again (with the same Idempotency-Key). |
| 503 | The studio can't reach its AI models right now (`studioModelsOut: true`). It's on the studio's side and nothing was charged. Try again after `Retry-After` seconds; the answer isn't kept under an Idempotency-Key. |

## Examples

With a key in `TARKOVSKY_KEY`. The projects you can open:

```sh
curl -s https://tarkovsky.ai/agent/v1/api/projects \
  -H "Authorization: Bearer $TARKOVSKY_KEY"
```

Read a project, then save its logline with the revision you read:

```sh
curl -s https://tarkovsky.ai/agent/v1/api/projects/$PROJECT -H "Authorization: Bearer $TARKOVSKY_KEY"

curl -s -X PUT https://tarkovsky.ai/agent/v1/api/projects/$PROJECT \
  -H "Authorization: Bearer $TARKOVSKY_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: logline-1" \
  -d '{"revision": 7, "data": {"logline": "Emina waits at the ferry for a man the river may keep."}}'
```

A tool over REST:

```sh
curl -s -X POST https://tarkovsky.ai/agent/v1/tools/get_script \
  -H "Authorization: Bearer $TARKOVSKY_KEY" -H "Content-Type: application/json" \
  -d '{"projectId": "'$PROJECT'"}'
```

Any studio route from an MCP client, through `studio_request`:

```sh
curl -s -X POST https://tarkovsky.ai/mcp \
  -H "Authorization: Bearer $TARKOVSKY_KEY" -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "studio_request", "arguments": {"method": "GET", "path": "/api/projects"}}}'
```

## The tools (26)

The same tools over MCP and REST. In MCP each carries its annotations (read-only, destructive, idempotent); in REST its input is the JSON body. 4 are paid.

- `list_projects`: List the filmmaker's projects
- `get_project`: Read a project's state
- `get_script`: Read the script
- `get_shots`: Read the shot list
- `get_storyboard`: Read the storyboard
- `get_takes`: Read the takes
- `get_cuts`: Read the cuts and renders
- `get_credits`: Read credits and limits
- `get_jobs`: Read jobs
- `wait_for_jobs`: Wait for jobs to land
- `make_still`: Make a still (paid)
- `make_take`: Make a take (paid)
- `render`: Render the cut
- `get_take_sheet`: Look at a take
- `set_cuts`: Write the cut
- `create_project`: Create a project
- `estimate_film`: Estimate the film
- `start_run`: Start Create With AI (paid)
- `get_run`: Follow the run
- `stop_run`: Stop the run
- `resume_run`: Run on to the next stage (paid)
- `love_still`: Love a still
- `love_take`: Love a take
- `lock_script`: Lock the script
- `lock_board`: Lock the board
- `studio_request`: Make one studio request

### list_projects: List the filmmaker's projects

Use this first, when you need a project's id or want to know what the filmmaker has in Tarkovsky. Returns each project's id, title, kind, logline, when it last changed, the filmmaker's role on it, and whether it is their copy of the sample film. Archived projects are left out unless asked for. Changes nothing.

**Free. It only reads.** REST: `POST /agent/v1/tools/list_projects` with the inputs as a JSON body. MCP: `tools/call` with `name: "list_projects"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `includeArchived` | boolean | no | Include archived projects. |

### get_project: Read a project's state

Use this to see where a project stands before planning work: title, logline, whether the script is locked, whether the kickoff is answered, whether paid steps wait for it (kickoffRequired: it is marked required, or a Tarkovsky Director run is on), the project's video model (none chosen: takes use the studio's default), how many scenes, shots, stills and takes exist and how many are loved, the cuts, the project's budget and spend, and the link that opens it in the studio. Changes nothing.

**Free. It only reads.** REST: `POST /agent/v1/tools/get_project` with the inputs as a JSON body. MCP: `tools/call` with `name: "get_project"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |

### get_script: Read the script

Use this to read a project's screenplay: the locked script when there is one (production works from it), else the working draft, with the scenes (id, heading, who and what is tagged in each). Use the scene ids with get_shots. Changes nothing.

**Free. It only reads.** REST: `POST /agent/v1/tools/get_script` with the inputs as a JSON body. MCP: `tools/call` with `name: "get_script"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |

### get_shots: Read the shot list

Use this to see the planned shots of a project or one scene: each shot's label, size, move, duration, description and dialogue, its keyframes (first, key, last; which still is loved), its parts, and sidesChange when someone crosses in it (its people may then change sides of the frame between its keyframes). Use the shot and keyframe ids with make_still and make_take. Changes nothing.

**Free. It only reads.** REST: `POST /agent/v1/tools/get_shots` with the inputs as a JSON body. MCP: `tools/call` with `name: "get_shots"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |
| `sceneId` | string (uuid) | no | One scene's shots only. |

### get_storyboard: Read the storyboard

Use this to see the stills made for each keyframe (media ids and which is loved) and the places' plates, so you know what exists before making more. Media opens in the studio for the signed-in filmmaker. Changes nothing.

**Free. It only reads.** REST: `POST /agent/v1/tools/get_storyboard` with the inputs as a JSON body. MCP: `tools/call` with `name: "get_storyboard"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |
| `sceneId` | string (uuid) | no | One scene only. |

### get_takes: Read the takes

Use this to see the video takes made for the shots (or one shot): name, part, the video model, the media id, and whether it is loved (a loved take is the one the cut uses). Changes nothing.

**Free. It only reads.** REST: `POST /agent/v1/tools/get_takes` with the inputs as a JSON body. MCP: `tools/call` with `name: "get_takes"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |
| `shotId` | string (uuid) | no | One shot's takes only. |

### get_cuts: Read the cuts and renders

Use this to see the edit's versions (sequences; which is current) and the finished renders of the film, with their labels and sizes, before rendering again. Changes nothing.

**Free. It only reads.** REST: `POST /agent/v1/tools/get_cuts` with the inputs as a JSON body. MCP: `tools/call` with `name: "get_cuts"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |

### get_credits: Read credits and limits

Use this before paid work and whenever the filmmaker asks what something cost: the wallet's balance and plan, this link's budget, what it has spent or holds and what is left, and, with a project id, that project's own budget and spend, and the page with the plans and credit prices (pricing). Credits are bought on the filmmaker's site, never here. Changes nothing.

**Free. It only reads.** REST: `POST /agent/v1/tools/get_credits` with the inputs as a JSON body. MCP: `tools/call` with `name: "get_credits"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | no | Also the project's budget and spend. |

### get_jobs: Read jobs

Use this to see the state of stills, takes and renders in progress or landed (queued, running, succeeded, failed; the media id when landed; the error when not). Give job ids to read only those. Changes nothing.

**Free. It only reads.** REST: `POST /agent/v1/tools/get_jobs` with the inputs as a JSON body. MCP: `tools/call` with `name: "get_jobs"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |
| `jobIds` | string (uuid)[] (at most 50) | no | Only these jobs. |

### wait_for_jobs: Wait for jobs to land

Use this after make_still, make_take or render to wait for the jobs to land, up to 55 seconds a call (call it again if some are still running). Reports progress while it waits and answers which jobs landed and how. Spends nothing.

**Free. It only reads.** REST: `POST /agent/v1/tools/wait_for_jobs` with the inputs as a JSON body. MCP: `tools/call` with `name: "wait_for_jobs"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |
| `jobIds` | string (uuid)[] (at most 50) | yes | The jobs to wait for. |
| `seconds` | integer (5–55) | no | How long to wait at most (default 30). |

### make_still: Make a still

Use this when a shot needs a picture: it makes the stills of a shot's keyframes that have none loved (or one keyframe again, with a note). The studio builds the prompt and references from the plan; you write no prompt. Costs credits: before it runs the studio holds up to the quoted ceiling (the answer gives ceilingCredits, the most it can cost, and heldCredits, what the studio held), charges the real cost when it lands, and nothing for an unusable answer. Refused, with nothing held, past this link's budget, the project's budget or the remake limit, or before the kickoff is answered when it is required (get_project's kickoffRequired). Returns at once with job ids: use wait_for_jobs.

**Paid: credits are held first, within the connection's budget, with the spend scope.** REST: `POST /agent/v1/tools/make_still` with the inputs as a JSON body. MCP: `tools/call` with `name: "make_still"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |
| `shotId` | string (uuid) | yes | The shot (from get_shots). |
| `keyframeId` | string (uuid) | no | One keyframe to make again (else every keyframe of the shot with no loved still). |
| `note` | string (0–500 chars) | no | What to change, for a keyframe made again. |
| `remake` | boolean | no | Make every keyframe of the shot again, loved ones too. |
| `titleInPicture` | boolean | no | true: draw the title the shot's words ask for (exemplified by, but not limited to, a TITLE: or SUPER: line, or a title in quotation marks) in the shot's stills and takes, as the filmmaker's “Put it in the picture anyway” does. Leave it out, and the shot keeps the filmmaker's choice; with none, the title stays out of the picture. Refused, with nothing held, when the shot's words ask for no title or the filmmaker chose “Add it in Edit”. |

### make_take: Make a take

Use this when a shot has its stills loved and needs its video take: it makes the takes of the shot's parts that have none loved (or one part again, with a note), on the project's video model unless another is named. The board must be locked and the frames loved. Costs credits as make_still does (held up to the ceiling, settled on landing, nothing for an unusable answer); refused with nothing held past the budgets, or before a required kickoff is answered. Returns at once with job ids.

**Paid: credits are held first, within the connection's budget, with the spend scope.** REST: `POST /agent/v1/tools/make_take` with the inputs as a JSON body. MCP: `tools/call` with `name: "make_take"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |
| `shotId` | string (uuid) | yes | The shot (from get_shots). |
| `part` | integer (1–20) | no | One part of the shot to make again (1-based). |
| `note` | string (0–500 chars) | no | A direction for the retake. |
| `model` | string (0–200 chars) | no | A video model id from the studio's catalog (else the project's). |
| `frames` | "first" \| "both" | no | Send the first frame only, or first and last. |
| `titleInPicture` | boolean | no | true: draw the title the shot's words ask for (exemplified by, but not limited to, a TITLE: or SUPER: line, or a title in quotation marks) in the shot's stills and takes, as the filmmaker's “Put it in the picture anyway” does. Leave it out, and the shot keeps the filmmaker's choice; with none, the title stays out of the picture. Refused, with nothing held, when the shot's words ask for no title or the filmmaker chose “Add it in Edit”. |

### render: Render the cut

Use this when the cut is ready to watch: it renders the current version of the edit (or a named version or one scene) to a screening copy. Renders spend no credits but take minutes and count toward the account's render queue. Returns at once with a job id; the file is listed by get_cuts when it lands and opens in the studio.

**Free. It changes the project.** REST: `POST /agent/v1/tools/render` with the inputs as a JSON body. MCP: `tools/call` with `name: "render"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |
| `sequenceId` | string (uuid) | no | A version of the edit (from get_cuts); else the current one. |
| `sceneId` | string (uuid) | no | Render one scene of the cut. |

### get_take_sheet: Look at a take

Use this before set_cuts, to see what is in a take: its contact sheets (frames from the whole take, about two a second, each with its time in seconds in its top-left corner), the planned lines, where someone speaks in it, and, once it is transcribed, every word said with its time, and the rule a cut in it keeps. The sheets come as pictures after the answer. Use it to choose the loved takes and where to cut them. Free; changes nothing.

**Free. It only reads.** REST: `POST /agent/v1/tools/get_take_sheet` with the inputs as a JSON body. MCP: `tools/call` with `name: "get_take_sheet"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |
| `takeId` | string (uuid) | yes | The take (from get_takes). |
| `images` | boolean | no | Send the contact sheets as pictures (default true); false answers the times, speech and words alone. |

### set_cuts: Write the cut

Use this to edit the film from its loved takes: it writes the cut of one scene (sceneId: the scene's clips are replaced where it sits in the edit) or of the whole film (no sceneId), the cuts in the order they play, each a loved take with its in and out point in seconds inside the take. It is checked first, as the studio's Rough Cut is: loved takes only; on a shot with lines no cut inside speech (between two words is fine once the take has its words: get_take_sheet); the parts of a shot that play one after the other join untrimmed. A refused cut changes nothing and says why. The cut is a new version of the edit, made from the current one and made current (the version before stays as it was); pass the sequenceId it answers to write into it again. The loved takes it doesn't use wait on V2, switched off. It is one line in Edit's History, which the filmmaker can undo. Free: no model, no credits. Then render it.

**Free. It changes the project.** REST: `POST /agent/v1/tools/set_cuts` with the inputs as a JSON body. MCP: `tools/call` with `name: "set_cuts"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |
| `sceneId` | string (uuid) | no | One scene's cut (the scene ids are in get_script and get_shots); leave it out for the whole film. |
| `cuts` | object[] (at most 400) | yes | The cuts, in the order they play: each a loved take's takeId, its in and out points in seconds inside the take, and why (optional). |
| `note` | string (0–1000 chars) | no | What this cut is for, in the filmmaker's words (shown in Edit's History). |
| `sequenceId` | string (uuid) | no | The version of the edit to write into, which must be the current one (get_cuts), such as the one the last set_cuts made. Leave it out to make a new version. |

### create_project: Create a project

Use this when the filmmaker wants a new film in Tarkovsky: it creates the project (a film, a commercial or a single shot) with its title and logline, and saves the script if the filmmaker has one. Without a script, start_run writes it from their story. Counts toward the plan's projects; spends no credits.

**Free. It changes the project.** REST: `POST /agent/v1/tools/create_project` with the inputs as a JSON body. MCP: `tools/call` with `name: "create_project"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `title` | string (1–200 chars) | yes | The project's title. |
| `type` | "Film" \| "Commercial" \| "Single shot" | no | Film unless the filmmaker says otherwise. |
| `logline` | string (0–2000 chars) | no | One or two sentences: what the film is. |
| `ratio` | "16:9" \| "21:9" \| "2.39:1" \| "9:16" \| "1:1" | no | The frame: 16:9 unless the filmmaker says otherwise. |
| `script` | string (0–200000 chars) | no | The filmmaker's screenplay, as they wrote it (scene headings, action, dialogue). Leave it out to have the script written from their story. |

### estimate_film: Estimate the film

Use this before start_run when the filmmaker wants to know what making the film with Tarkovsky Director will cost: the whole-film estimate in credits, stage by stage, from where the project stands. Free; changes nothing.

**Free. It only reads.** REST: `POST /agent/v1/tools/estimate_film` with the inputs as a JSON body. MCP: `tools/call` with `name: "estimate_film"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |
| `model` | string (0–200 chars) | no | One of the Director's models (get_run lists them); else the first offered. |

### start_run: Start Create With AI

Use this to make the film automatically with Tarkovsky Director, up to a stage the filmmaker chooses (upTo: script, shotlist, stills, takes, roughcut or export), so they can review and correct it there before the next stage (resume_run). When the kickoff isn't answered yet, it is answered for them with every area handed to the Director, the stage, and their story and the film's length if given. Costs credits: the run's whole budget counts on this connection while it runs, and the run never spends past it; refused, with nothing started, past this connection's budget, the wallet or the project's budget. Returns at once; follow it with get_run.

**Paid: credits are held first, within the connection's budget, with the spend scope.** REST: `POST /agent/v1/tools/start_run` with the inputs as a JSON body. MCP: `tools/call` with `name: "start_run"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |
| `budgetCredits` | integer (1–1000000) | yes | The most the run may spend, in credits. At least about three of the Director's turns (estimate_film): a smaller run is refused. |
| `upTo` | "script" \| "shotlist" \| "stills" \| "takes" \| "roughcut" \| "export" | yes | Where the run stops for the filmmaker's review. |
| `story` | string (0–40000 chars) | no | What the film is about, in the filmmaker's words (notes, or a synopsis), when there is no script yet. |
| `filmMinutes` | integer (1–180) | no | How long the film should be, in minutes. |
| `note` | string (0–2000 chars) | no | A direction for this run, in the filmmaker's words. |
| `model` | string (0–200 chars) | no | One of the Director's models; else the first offered. |

### get_run: Follow the run

Use this while Tarkovsky Director works, and when it stops: the run's state (working, stopping, stopped, finished), its step, what it has spent of its budget, the stage it stops at, how it ended (a run that stopped to wait for the filmmaker says what for), what it logged since the line you last saw (afterLine), what it decided for the filmmaker, which tool goes on (next), and the Director's models. Changes nothing.

**Free. It only reads.** REST: `POST /agent/v1/tools/get_run` with the inputs as a JSON body. MCP: `tools/call` with `name: "get_run"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |
| `afterLine` | integer (0–9007199254740991) | no | The last log line you saw (lastLine from the previous answer). |

### stop_run: Stop the run

Use this when the filmmaker wants Tarkovsky Director to stop: no new paid work starts; stills and takes already running land, then the run writes its report. Nothing is lost; resume_run carries on.

**Free. It changes the project.** REST: `POST /agent/v1/tools/stop_run` with the inputs as a JSON body. MCP: `tools/call` with `name: "stop_run"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |

### resume_run: Run on to the next stage

Use this after the filmmaker has reviewed and corrected a stopped run (stop_run, or the Director stopped to wait for them: get_run's ended says what for): it runs on, up to the next stage they choose (upTo), with more budget and their direction (note). A run that finished at its stage isn't resumed: start_run with the next stage carries the same project on. Costs credits as start_run does: the run's budget counts on this connection while it runs; refused, with nothing started, past this connection's budget.

**Paid: credits are held first, within the connection's budget, with the spend scope.** REST: `POST /agent/v1/tools/resume_run` with the inputs as a JSON body. MCP: `tools/call` with `name: "resume_run"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |
| `budgetCredits` | integer (1–1000000) | yes | More budget for the run, in credits, on top of what it has spent. |
| `upTo` | "script" \| "shotlist" \| "stills" \| "takes" \| "roughcut" \| "export" | no | Where the run stops next; else where it stopped before. |
| `note` | string (0–2000 chars) | no | What the filmmaker wants changed or kept, in their words. |

### love_still: Love a still

Use this when the filmmaker chooses which still a keyframe uses (a loved still is the frame takes are made from, and the reference for the shots after it). A still whose check found a must-fix problem, or that has no check yet, is refused: the filmmaker decides that one in the studio, or you remake it with a note (make_still). Spends no credits.

**Free. It changes the project.** REST: `POST /agent/v1/tools/love_still` with the inputs as a JSON body. MCP: `tools/call` with `name: "love_still"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |
| `shotId` | string (uuid) | yes | The shot (from get_shots). |
| `keyframeId` | string (uuid) | yes | The keyframe (from get_shots). |
| `mediaId` | string (uuid) | yes | The still to love (from get_storyboard). |

### love_take: Love a take

Use this when the filmmaker chooses which take a shot uses (the cut uses loved takes). A take with a must-fix finding, or with a cut or dissolve inside it, is refused: the filmmaker decides that one in the studio, or you remake it with a note (make_take). Spends no credits.

**Free. It changes the project.** REST: `POST /agent/v1/tools/love_take` with the inputs as a JSON body. MCP: `tools/call` with `name: "love_take"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |
| `takeId` | string (uuid) | yes | The take to love (from get_takes). |

### lock_script: Lock the script

Use this when the filmmaker approves the script: locking makes it the production script (scenes, people and places tagged), which shots are planned from. Free. A locked script changes only in the studio.

**Free. It changes the project.** REST: `POST /agent/v1/tools/lock_script` with the inputs as a JSON body. MCP: `tools/call` with `name: "lock_script"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |

### lock_board: Lock the board

Use this when the filmmaker approves the storyboard: takes are made only for the shots on the locked board. Free. Unlock it in the studio to change the board.

**Free. It changes the project.** REST: `POST /agent/v1/tools/lock_board` with the inputs as a JSON body. MCP: `tools/call` with `name: "lock_board"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `projectId` | string (uuid) | yes | The project's id (from list_projects). |

### studio_request: Make one studio request

Use this for anything in the studio no other tool here does: one request to the studio's own API as the filmmaker, with the same checks, prices and guards as the page. Paths start with /api/ (every route open to you is in the API reference, https://tarkovsky.ai/agent/v1/openapi.json, with what it costs) or are /media/<id> for a file. GET reads; POST, PUT and PATCH change the project; a paid route holds credits within this connection's budget, and a refusal says why in plain words. Nothing is deleted from here. Stills and takes go through make_still and make_take, which build their prompts; the Director through start_run. Answers are {status, body}; a long one is cut to maxChars, and pick keeps only the fields you name.

**Free. It only reads.** REST: `POST /agent/v1/tools/studio_request` with the inputs as a JSON body. MCP: `tools/call` with `name: "studio_request"`.

| Input | Type | Required | What it is |
| --- | --- | --- | --- |
| `method` | "GET" \| "POST" \| "PUT" \| "PATCH" | yes | GET reads; POST, PUT and PATCH change. |
| `path` | string (5–500 chars) | yes | The route with its query string, as in the API reference without /agent/v1, e.g. /api/projects/<id>/kickoff. |
| `body` | object | no | The JSON body (POST, PUT, PATCH). |
| `pick` | string (0–200 chars)[] (at most 40) | no | Dotted paths to keep, e.g. ['revision','data.shots[].id']; '[]' maps over an array. |
| `maxChars` | integer (200–40000) | no | Cut the answer to this many characters (default 4000). |

## The studio's routes at the door (409)

Each is the studio's own `/api/…` route, called at `https://tarkovsky.ai/agent/v1/api/…` (the paths below), as the page calls it. Bodies are the page's JSON. Read the route's answer for its shape. The OpenAPI document lists the same routes with their money class.

- studio: The studio's own routes: the session, projects, saving, media, jobs and the model catalogs.
- billing: 
- agent-runs: 
- ask-takes: a new take's own changes, kept for it (free)
- angle-set-routes: POST /:assetId/angles/quote (free), POST /:assetId/angles (paid), GET /:assetId/angles
- description-impact-routes: POST /:assetId/description, /description-offers/:offerId (free)
- description-remake-routes: POST /:assetId/description/remake/quote (free), /:assetId/description/remake (paid)
- asset-desk-routes: POST /:assetId/heart, /:assetId/like, GET /:assetId/desk (free); 0.66: POST /:assetId/group (free)
- assets: 
- marks-check-routes: POST /:assetId/marks-check, a person's check of a profile against the marks and sides line (free)
- sheet-check-routes: POST /assets/:assetId/sheet-check (/quote free), GET /sheet-checks, POST /sheet-checks/:checkId/outcome
- heart-change-routes: made-from, preview, compare, apply, remake, likes, remakes, flags
- board-routes: move, duplicate, on/off, delete, insert, undo, redo, jump, lock, the take quote
- scene-insert-routes: a new scene for a loose shot of another place (free)
- board-version-routes: GET /versions, /versions/:n, POST /versions/:n/start, /versions/:n/rename (free)
- boards: each frame's grey-box board by Blender (farm or this host), free; bring your own (since 0.71.3, TAR-974, its upload takes `shows` and `rights=confirmed` as the media upload does)
- brainstorm-routes: the thread, the quote, a change within the limit, Keep going, the end
- kickoff-brainstorm-routes: Draft it on the kickoff's story, its quote
- brief: 
- project-budget: GET the spend against the budget
- chat: 
- critic-routes: the instruments, the quote, a pass, the passes, a person's marks
- part-chain: a later part's chain on a first-frame-only model
- dailies-desk-routes: POST /rate, /place, each with its History line (free)
- picture-change-routes: Change this picture
- direction-routes: propose, pin, check (see direction-routes.ts)
- edit-beds-routes: POST /: the ripple question's choice, with its History line (free)
- edit-routes: POST /speech, GET /checks
- edit-titles-routes: POST /titles/line, POST /cutdowns, each with its History line (free)
- cut-routes: POST /cuts/quote, POST /cuts: Go to Edit's new cut (free)
- edit-desk-routes: GET, PUT: the filmmaker's own folds and band height for this project (their settings, free)
- edit-flag-routes: POST /aside, Not a problem with its History line (free)
- edit-level-routes: POST /: a level line's change, with its History line (free)
- voice-link-routes: POST /: Link or Unlink a voice, with its History line (free)
- edit-remake-routes: POST /remake/plan, POST /remake (free; stills and takes go through /jobs)
- rough-cut: POST /rough-cut/quote, POST /rough-cut
- export-desk-routes: limits, renders, compare, checks, set-asides, captions, hand-offs
- flags-routes: GET the flags, Not a problem, Undo, Generate a take with this fix
- floor-plan-routes: read, seed, edit, check (free)
- edit-sequences: /sequences…, /frame-rate
- gallery-routes: series, /me, /viewer, /follow
- history-routes: GET ?page=, POST /:entryId/undo, /:entryId/redo
- kickoff-routes: 
- commercial-write-routes: 
- kickoff-script-auto: 
- place-map-routes: the map's reads, ops, OK and Join at the door (free)
- plan-redraw-routes: Redraw from the script (free to the filmmaker)
- media-info: `anatomy` for an administrator // 0.20 (TAR-214): GET /:mediaId/info, /:mediaId/info/sidecar
- music-routes: 
- release-packages: build and download the Release packages; free
- palette-routes: db for the words' model reading · 0.22 (round 10 §10, TAR-265): a palette from a file, a photo or words (free, nothing stored)
- waveforms: GET ?media=… the waveforms of sound clips (members, free)
- upscale-routes: /picture/lock, /picture/unlock, /upscale…
- places-routes: the places, their plans and joins (free)
- plan-cut-routes: a cut the words ask for, offered as a mark, free
- pre-take: 
- continuity-routes: the shots beside it, a take compared with the take of the shot before it, and its switch (off unless turned on)
- dailies-critic-routes: the Critic on Dailies, a take watched as it lands, and its switch
- dissolve-routes: the dissolve check on every take, the longer take or part 2
- take-gate: before Generate a take's hold, free
- take-match-routes: the take-match check, switched off
- motion-check-routes: quote, run, the latest per take, the automatic setting
- pretake-notes-routes: Real / Noise, acted / ignored, the rate
- pretake-recheck: only the remade keyframes
- still-check: 
- questions-routes: the open questions (Check script, the writer's, Check shot list's notes) and their answers (free)
- remake-limit-routes: the setting in force, the spend, a verdict
- renders-routes: GET the finished renders (any member)
- render-stop: POST /:jobId/stop, editors, free
- content-research-routes: 
- rights: the rights question's switch (off)
- screener-routes: list, make (the link once), revoke, views; free
- sfx-routes: effects and ambience, quote first, with {kind: "effects" or "ambience", text, start, end} in seconds of the cut, then maxCredits; the sounds the script names
- prompt-shorten-routes: Shorten and make's shortening (quote free, the call paid)
- project-store-routes: History's copies beside the project, the read cache (on), the copies back
- scene-notes-routes: GET, PUT: which scenes' notes boxes this person hid on the Shot List (their settings, free)
- shot-chat: the Shot List's chat and review
- sound-only: GET, POST /quote (free), POST (paid), POST /picture (free)
- breakdown: 
- story: 
- script-coverage: 
- coverage-brainstorm-routes: 
- storyboard-routes: the paper edit, describe a shot, batch Make, two models
- cut-reply-routes: Reply on a cut's offer: its quote and its paid answer
- help-draft-routes: Help draft's quote and its paid new version
- move-end-reply-routes: Reply on a move's end: its quote and its paid answer
- board-make-routes: the new-shot panel's quote, Make it, the waiting stills
- plan-routes: OK the plan, Keep (free), Remake them (paid, its quote free)
- plan2-routes: Make this plate, the plan drawn from words (paid, quotes free)
- style-routes: PUT / (free), POST /write (free), /brainstorm/quote, /brainstorm (paid), /palette (free), /remake/quote, /remake (paid)
- agent-cuts: GET /take-sheet/:takeId, POST /cut-list (free)
- take-whole-routes: a shot's takes of the whole shot, remake a part, Try again, join
- theirs-routes: GET, PUT: "You're editing Costa's project. Duplicate the board?", once per project per person (their settings, free)
- production-tools: Propose coverage; for a scene of title cards only at BLACK, generate answers 200 { status: "cards-only", data: [] } with no id, and nothing is quoted, held or charged
- media-uploads: POST, PUT /:uploadId/parts/:n, POST /:uploadId/finish, DELETE /:uploadId (free; /media below is unchanged)
- vertical-routes: GET/POST /renders/:jobId, PUT /centers; free
- viewfinder-routes: read a framing and its sketch; start, camera, people, line, last frame, new shots, the page's ops (free)
- voice: 
- voice-over: GET, POST /quote (free), POST (paid)
- wip-routes: GET, PUT /:tabId, POST /:tabId/discard|restore: the filmmaker's Work in progress tabs (free, their own)

### studio: The studio's own routes: the session, projects, saving, media, jobs and the model catalogs.

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/assistant/settings` | free |  |
| GET | `/agent/v1/api/images/models` | free |  |
| POST | `/agent/v1/api/images/quote` | quote (free; nothing held) |  |
| GET | `/agent/v1/api/managed/models` | free |  |
| GET | `/agent/v1/api/models/defaults` | free |  |
| GET | `/agent/v1/api/projects` | free |  |
| GET | `/agent/v1/api/projects/{id}` | free |  |
| PATCH | `/agent/v1/api/projects/{id}` | free | the save as what it changed (0.68.5), by the PUT's rules: without `kickoff` in its patch (the kickoff is the filmmaker's) |
| PUT | `/agent/v1/api/projects/{id}` | free | the save, without `kickoff` in its data (the kickoff is the filmmaker's) |
| GET | `/agent/v1/api/projects/{id}/access` | free |  |
| POST | `/agent/v1/api/projects/{id}/chat` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/drafts` | free |  |
| GET | `/agent/v1/api/projects/{id}/export/{format}` | free |  |
| POST | `/agent/v1/api/projects/{id}/fresh` | free | a read: what changed since the caller's own copy (0.68.5) |
| GET | `/agent/v1/api/projects/{id}/jobs` | free |  |
| POST | `/agent/v1/api/projects/{id}/jobs` | paid (credits held first) | kind render here; a still or a take through make_still or make_take, which build its prompt as the page does |
| POST | `/agent/v1/api/projects/{id}/lock` | free |  |
| POST | `/agent/v1/api/projects/{id}/managed/chat` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/managed/quote` | quote (free; nothing held) |  |
| GET | `/agent/v1/api/projects/{id}/media` | free |  |
| POST | `/agent/v1/api/projects/{id}/media` | free |  |
| GET | `/agent/v1/api/projects/{id}/revision` | free |  |
| GET | `/agent/v1/api/session` | free |  |
| GET | `/agent/v1/api/video/models` | free |  |
| POST | `/agent/v1/api/video/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/voice/quote` | quote (free; nothing held) |  |
| GET | `/agent/v1/api/voice/services` | free |  |
| GET | `/agent/v1/api/voices` | free |  |
| GET | `/agent/v1/media/{id}` | free |  |

### billing

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/billing` | free |  |
| GET | `/agent/v1/api/billing/usage` | free |  |

### agent-runs

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/agent/runs` | free |  |
| GET | `/agent/v1/api/projects/{id}/agent/runs/{run}` | free |  |
| POST | `/agent/v1/api/projects/{id}/agent/runs/{run}/deadline` | free |  |
| POST | `/agent/v1/api/projects/{id}/agent/runs/{run}/decisions` | free |  |
| GET | `/agent/v1/api/projects/{id}/agent/runs/{run}/flags` | free |  |
| POST | `/agent/v1/api/projects/{id}/agent/runs/{run}/problems` | free |  |
| PATCH | `/agent/v1/api/projects/{id}/agent/runs/{run}/problems/{problem}` | free |  |
| GET | `/agent/v1/api/projects/{id}/agent/runs/{run}/report` | free |  |
| POST | `/agent/v1/api/projects/{id}/agent/runs/{run}/story-draft` | free |  |
| POST | `/agent/v1/api/projects/{id}/agent/runs/{run}/story-flag` | free |  |

### ask-takes: a new take's own changes, kept for it (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/ask-takes` | free |  |
| POST | `/agent/v1/api/projects/{id}/ask-takes` | free | a shot's next take's own changes, checked against the shot; never the project's stored data |
| POST | `/agent/v1/api/projects/{id}/ask-takes/{rowId}/made` | free | the project's own jobs only |

### angle-set-routes: POST /:assetId/angles/quote (free), POST /:assetId/angles (paid), GET /:assetId/angles

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/assets/{assetId}/angles` | free |  |
| POST | `/agent/v1/api/projects/{id}/assets/{assetId}/angles` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/assets/{assetId}/angles/quote` | quote (free; nothing held) |  |

### description-impact-routes: POST /:assetId/description, /description-offers/:offerId (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/assets/{assetId}/description` | free |  |
| POST | `/agent/v1/api/projects/{id}/assets/description-offers/{offerId}` | free |  |

### description-remake-routes: POST /:assetId/description/remake/quote (free), /:assetId/description/remake (paid)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/assets/{assetId}/description/remake` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/assets/{assetId}/description/remake/quote` | quote (free; nothing held) |  |

### asset-desk-routes: POST /:assetId/heart, /:assetId/like, GET /:assetId/desk (free); 0.66: POST /:assetId/group (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/assets/{assetId}/desk` | free |  |
| POST | `/agent/v1/api/projects/{id}/assets/{assetId}/group` | free |  |
| POST | `/agent/v1/api/projects/{id}/assets/{assetId}/heart` | free |  |
| POST | `/agent/v1/api/projects/{id}/assets/{assetId}/like` | free |  |

### assets

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/assets/{assetId}/label-check` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/assets/{assetId}/label-check/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/projects/{id}/assets/{assetId}/set-pack/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/projects/{id}/assets/brand-rules/draft` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/assets/brand-rules/quote` | quote (free; nothing held) |  |

### marks-check-routes: POST /:assetId/marks-check, a person's check of a profile against the marks and sides line (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/assets/{assetId}/marks-check` | free |  |

### sheet-check-routes: POST /assets/:assetId/sheet-check (/quote free), GET /sheet-checks, POST /sheet-checks/:checkId/outcome

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/assets/{assetId}/sheet-check` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/assets/{assetId}/sheet-check/quote` | quote (free; nothing held) |  |
| GET | `/agent/v1/api/projects/{id}/sheet-checks` | free |  |
| POST | `/agent/v1/api/projects/{id}/sheet-checks/{checkId}/outcome` | free |  |

### heart-change-routes: made-from, preview, compare, apply, remake, likes, remakes, flags

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/assets/hearts/apply` | free |  |
| POST | `/agent/v1/api/projects/{id}/assets/hearts/compare` | paid (credits held first) |  |
| GET | `/agent/v1/api/projects/{id}/assets/hearts/flags` | free |  |
| POST | `/agent/v1/api/projects/{id}/assets/hearts/likes` | free |  |
| GET | `/agent/v1/api/projects/{id}/assets/hearts/made-from` | free |  |
| POST | `/agent/v1/api/projects/{id}/assets/hearts/preview` | free |  |
| POST | `/agent/v1/api/projects/{id}/assets/hearts/remake` | paid (credits held first) |  |
| GET | `/agent/v1/api/projects/{id}/assets/hearts/remakes` | free |  |

### board-routes: move, duplicate, on/off, delete, insert, undo, redo, jump, lock, the take quote

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/board/delete` | free |  |
| POST | `/agent/v1/api/projects/{id}/board/duplicate` | free |  |
| POST | `/agent/v1/api/projects/{id}/board/insert` | free |  |
| POST | `/agent/v1/api/projects/{id}/board/join` | free |  |
| POST | `/agent/v1/api/projects/{id}/board/jump` | free |  |
| POST | `/agent/v1/api/projects/{id}/board/lock` | free |  |
| POST | `/agent/v1/api/projects/{id}/board/move` | free |  |
| POST | `/agent/v1/api/projects/{id}/board/off` | free |  |
| POST | `/agent/v1/api/projects/{id}/board/place` | free |  |
| POST | `/agent/v1/api/projects/{id}/board/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/projects/{id}/board/redo` | free |  |
| POST | `/agent/v1/api/projects/{id}/board/undo` | free |  |

### scene-insert-routes: a new scene for a loose shot of another place (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/board/scenes` | free |  |
| POST | `/agent/v1/api/projects/{id}/board/scenes/ask` | free |  |

### board-version-routes: GET /versions, /versions/:n, POST /versions/:n/start, /versions/:n/rename (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/board/versions` | free |  |
| GET | `/agent/v1/api/projects/{id}/board/versions/{n}` | free |  |
| POST | `/agent/v1/api/projects/{id}/board/versions/{n}/rename` | free |  |
| POST | `/agent/v1/api/projects/{id}/board/versions/{n}/start` | free |  |

### boards: each frame's grey-box board by Blender (farm or this host), free; bring your own (since 0.71.3, TAR-974, its upload takes `shows` and `rights=confirmed` as the media upload does)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/boards` | free |  |
| POST | `/agent/v1/api/projects/{id}/boards` | free |  |
| POST | `/agent/v1/api/projects/{id}/boards/upload` | free |  |

### brainstorm-routes: the thread, the quote, a change within the limit, Keep going, the end

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/brainstorm` | free |  |
| POST | `/agent/v1/api/projects/{id}/brainstorm/change` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/brainstorm/end` | free |  |
| POST | `/agent/v1/api/projects/{id}/brainstorm/keep-going` | paid (credits held first) |  |
| GET | `/agent/v1/api/projects/{id}/brainstorm/kept` | free |  |
| PUT | `/agent/v1/api/projects/{id}/brainstorm/kept` | free |  |
| POST | `/agent/v1/api/projects/{id}/brainstorm/kept/clear` | free |  |
| POST | `/agent/v1/api/projects/{id}/brainstorm/quote` | quote (free; nothing held) |  |

### kickoff-brainstorm-routes: Draft it on the kickoff's story, its quote

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/brainstorm/kickoff` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/brainstorm/kickoff/quote` | quote (free; nothing held) |  |

### brief

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/brief/draft` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/brief/import` | free |  |
| POST | `/agent/v1/api/projects/{id}/brief/quote` | quote (free; nothing held) |  |

### project-budget: GET the spend against the budget

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/budget` | free |  |

### chat

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/chat` | free |  |
| POST | `/agent/v1/api/projects/{id}/chat/messages` | free |  |
| PATCH | `/agent/v1/api/projects/{id}/chat/messages/{mid}` | free |  |
| GET | `/agent/v1/api/projects/{id}/chat/waits/{wait}` | free |  |

### critic-routes: the instruments, the quote, a pass, the passes, a person's marks

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/critic` | free |  |
| POST | `/agent/v1/api/projects/{id}/critic` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/critic/instruments` | free |  |
| POST | `/agent/v1/api/projects/{id}/critic/quote` | quote (free; nothing held) |  |

### part-chain: a later part's chain on a first-frame-only model

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/dailies/chain` | free |  |
| GET | `/agent/v1/api/projects/{id}/dailies/chains` | free |  |

### dailies-desk-routes: POST /rate, /place, each with its History line (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/dailies/note` | free |  |
| POST | `/agent/v1/api/projects/{id}/dailies/place` | free |  |
| POST | `/agent/v1/api/projects/{id}/dailies/rate` | free |  |

### picture-change-routes: Change this picture

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/direction/change` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/direction/change/quote` | quote (free; nothing held) |  |

### direction-routes: propose, pin, check (see direction-routes.ts)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/direction/check` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/direction/check/quote` | quote (free; nothing held) |  |
| GET | `/agent/v1/api/projects/{id}/direction/model-notes` | free |  |
| POST | `/agent/v1/api/projects/{id}/direction/performance-still` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/direction/performance-still/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/projects/{id}/direction/pin` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/direction/pin/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/projects/{id}/direction/propose` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/direction/propose/quote` | quote (free; nothing held) |  |
| GET | `/agent/v1/api/projects/{id}/direction/spend` | free |  |
| POST | `/agent/v1/api/projects/{id}/direction/take-note` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/direction/take-note/quote` | quote (free; nothing held) |  |

### edit-beds-routes: POST /: the ripple question's choice, with its History line (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/edit/beds` | free |  |

### edit-routes: POST /speech, GET /checks

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/edit/checks` | free |  |
| POST | `/agent/v1/api/projects/{id}/edit/speech` | free |  |
| GET | `/agent/v1/api/projects/{id}/edit/words` | free |  |
| POST | `/agent/v1/api/projects/{id}/edit/words` | free |  |

### edit-titles-routes: POST /titles/line, POST /cutdowns, each with its History line (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/edit/cutdowns` | free |  |
| POST | `/agent/v1/api/projects/{id}/edit/titles/line` | free |  |

### cut-routes: POST /cuts/quote, POST /cuts: Go to Edit's new cut (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/edit/cuts` | free |  |
| POST | `/agent/v1/api/projects/{id}/edit/cuts/quote` | quote (free; nothing held) |  |

### edit-desk-routes: GET, PUT: the filmmaker's own folds and band height for this project (their settings, free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/edit/desk` | free |  |
| PUT | `/agent/v1/api/projects/{id}/edit/desk` | free |  |

### edit-flag-routes: POST /aside, Not a problem with its History line (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/edit/flags/aside` | free |  |

### edit-level-routes: POST /: a level line's change, with its History line (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/edit/level` | free |  |

### voice-link-routes: POST /: Link or Unlink a voice, with its History line (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/edit/link` | free |  |

### edit-remake-routes: POST /remake/plan, POST /remake (free; stills and takes go through /jobs)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/edit/remake` | free |  |
| POST | `/agent/v1/api/projects/{id}/edit/remake/plan` | free |  |

### rough-cut: POST /rough-cut/quote, POST /rough-cut

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/edit/rough-cut` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/edit/rough-cut/quote` | quote (free; nothing held) |  |

### export-desk-routes: limits, renders, compare, checks, set-asides, captions, hand-offs

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/exports/captions.{fmt}` | free |  |
| GET | `/agent/v1/api/projects/{id}/exports/checks` | free |  |
| GET | `/agent/v1/api/projects/{id}/exports/compare` | free |  |
| GET | `/agent/v1/api/projects/{id}/exports/contents` | free |  |
| GET | `/agent/v1/api/projects/{id}/exports/handoffs` | free |  |
| POST | `/agent/v1/api/projects/{id}/exports/handoffs` | free |  |
| GET | `/agent/v1/api/projects/{id}/exports/handoffs/{hid}/download` | free |  |
| GET | `/agent/v1/api/projects/{id}/exports/limits` | free |  |
| GET | `/agent/v1/api/projects/{id}/exports/renders` | free |  |
| GET | `/agent/v1/api/projects/{id}/exports/set-asides` | free |  |
| POST | `/agent/v1/api/projects/{id}/exports/set-asides` | free |  |

### flags-routes: GET the flags, Not a problem, Undo, Generate a take with this fix

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/flags` | free |  |
| POST | `/agent/v1/api/projects/{id}/flags/{flagId}/dismiss` | free |  |
| POST | `/agent/v1/api/projects/{id}/flags/{flagId}/fix` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/flags/{flagId}/fix/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/projects/{id}/flags/{flagId}/undo` | free |  |
| POST | `/agent/v1/api/projects/{id}/flags/older` | free |  |

### floor-plan-routes: read, seed, edit, check (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/floor-plans` | free |  |
| GET | `/agent/v1/api/projects/{id}/floor-plans/{sceneId}` | free |  |
| PATCH | `/agent/v1/api/projects/{id}/floor-plans/{sceneId}` | free |  |
| PUT | `/agent/v1/api/projects/{id}/floor-plans/{sceneId}` | free |  |
| POST | `/agent/v1/api/projects/{id}/floor-plans/{sceneId}/check` | free |  |
| POST | `/agent/v1/api/projects/{id}/floor-plans/{sceneId}/seed` | free |  |
| GET | `/agent/v1/api/projects/{id}/floor-plans/{sceneId}/shots/{shotId}` | free |  |
| POST | `/agent/v1/api/projects/{id}/floor-plans/{sceneId}/update` | free |  |

### edit-sequences: /sequences…, /frame-rate

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/frame-rate` | free |  |
| GET | `/agent/v1/api/projects/{id}/sequences` | free |  |
| POST | `/agent/v1/api/projects/{id}/sequences` | free |  |
| GET | `/agent/v1/api/projects/{id}/sequences/{sid}` | free |  |
| PUT | `/agent/v1/api/projects/{id}/sequences/{sid}` | free |  |
| POST | `/agent/v1/api/projects/{id}/sequences/{sid}/archive` | free |  |
| POST | `/agent/v1/api/projects/{id}/sequences/{sid}/next-cut` | free |  |
| POST | `/agent/v1/api/projects/{id}/sequences/{sid}/rename` | free |  |
| POST | `/agent/v1/api/projects/{id}/sequences/{sid}/restore` | free |  |
| POST | `/agent/v1/api/projects/{id}/sequences/{sid}/send-order` | free |  |
| POST | `/agent/v1/api/projects/{id}/sequences/{sid}/star` | free |  |
| POST | `/agent/v1/api/projects/{id}/sequences/assembly` | free |  |
| GET | `/agent/v1/api/projects/{id}/sequences/boards` | free |  |
| GET | `/agent/v1/api/projects/{id}/sequences/rates` | free |  |
| POST | `/agent/v1/api/projects/{id}/sequences/rates` | free |  |

### gallery-routes: series, /me, /viewer, /follow

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/gallery` | free |  |

### history-routes: GET ?page=, POST /:entryId/undo, /:entryId/redo

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/history` | free |  |
| POST | `/agent/v1/api/projects/{id}/history/{entryId}/redo` | free |  |
| POST | `/agent/v1/api/projects/{id}/history/{entryId}/undo` | free |  |
| POST | `/agent/v1/api/projects/{id}/history/marks` | free |  |

### kickoff-routes

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/kickoff` | free |  |
| POST | `/agent/v1/api/projects/{id}/kickoff` | free | the production choices only (density, protection, the video model and its resolution, the motion check, splits on a locked board, the frame rate); the filmmaker's own answers go through start_run |
| POST | `/agent/v1/api/projects/{id}/kickoff/estimate` | quote (free; nothing held) |  |

### commercial-write-routes

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/kickoff/script` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/kickoff/script/quote` | quote (free; nothing held) |  |

### kickoff-script-auto

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/kickoff/script/auto` | free |  |
| POST | `/agent/v1/api/projects/{id}/kickoff/script/auto` | paid (credits held first) |  |

### place-map-routes: the map's reads, ops, OK and Join at the door (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/maps` | free |  |
| PATCH | `/agent/v1/api/projects/{id}/maps/{mapId}` | free |  |
| POST | `/agent/v1/api/projects/{id}/maps/{mapId}/join-at-door` | free |  |
| POST | `/agent/v1/api/projects/{id}/maps/{mapId}/ok` | free |  |
| POST | `/agent/v1/api/projects/{id}/maps/{mapId}/ok/undo` | free |  |

### plan-redraw-routes: Redraw from the script (free to the filmmaker)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/maps/redraw` | free |  |
| POST | `/agent/v1/api/projects/{id}/maps/redraw/quote` | quote (free; nothing held) |  |

### media-info: `anatomy` for an administrator // 0.20 (TAR-214): GET /:mediaId/info, /:mediaId/info/sidecar

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/media/{mediaId}/info` | free |  |
| GET | `/agent/v1/api/projects/{id}/media/{mediaId}/info/sidecar` | free |  |

### music-routes

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/music` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/music/draft` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/music/draft/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/projects/{id}/music/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/projects/{id}/music/range/quote` | quote (free; nothing held) |  |
| GET | `/agent/v1/api/projects/{id}/music/scripted` | free |  |

### release-packages: build and download the Release packages; free

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/packages` | free |  |
| GET | `/agent/v1/api/projects/{id}/packages/{pid}` | free |  |
| GET | `/agent/v1/api/projects/{id}/packages/{pid}/download` | free |  |

### palette-routes: db for the words' model reading · 0.22 (round 10 §10, TAR-265): a palette from a file, a photo or words (free, nothing stored)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/palette/brainstorm` | free |  |
| POST | `/agent/v1/api/projects/{id}/palette/propose` | free |  |
| GET | `/agent/v1/api/projects/{id}/palette/suggest` | free |  |

### waveforms: GET ?media=… the waveforms of sound clips (members, free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/peaks` | free |  |

### upscale-routes: /picture/lock, /picture/unlock, /upscale…

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/picture/lock` | free |  |
| POST | `/agent/v1/api/projects/{id}/picture/unlock` | free |  |
| GET | `/agent/v1/api/projects/{id}/upscale` | free |  |
| POST | `/agent/v1/api/projects/{id}/upscale` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/upscale/{jobId}/undo` | free |  |
| POST | `/agent/v1/api/projects/{id}/upscale/original` | free |  |

### places-routes: the places, their plans and joins (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/places` | free |  |
| GET | `/agent/v1/api/projects/{id}/places/{placeId}` | free |  |
| PATCH | `/agent/v1/api/projects/{id}/places/{placeId}` | free |  |
| PATCH | `/agent/v1/api/projects/{id}/places/{placeId}/areas/{areaAssetId}` | free |  |
| POST | `/agent/v1/api/projects/{id}/places/{placeId}/joins` | free |  |
| PATCH | `/agent/v1/api/projects/{id}/places/{placeId}/joins/{joinId}` | free |  |

### plan-cut-routes: a cut the words ask for, offered as a mark, free

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/plan-cuts/accept` | free |  |
| GET | `/agent/v1/api/projects/{id}/plan-cuts/offers` | free |  |

### pre-take

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/pretake` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/pretake/code` | free |  |
| POST | `/agent/v1/api/projects/{id}/pretake/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/projects/{id}/pretake/take` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/pretake/take/quote` | quote (free; nothing held) |  |

### continuity-routes: the shots beside it, a take compared with the take of the shot before it, and its switch (off unless turned on)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/pretake/continuity-critic` | free |  |
| POST | `/agent/v1/api/projects/{id}/pretake/continuity-critic` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/pretake/continuity-critic/quote` | quote (free; nothing held) |  |

### dailies-critic-routes: the Critic on Dailies, a take watched as it lands, and its switch

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/pretake/dailies-critic` | free |  |
| POST | `/agent/v1/api/projects/{id}/pretake/dailies-critic` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/pretake/dailies-critic/quote` | quote (free; nothing held) |  |

### dissolve-routes: the dissolve check on every take, the longer take or part 2

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/pretake/dissolve` | free |  |
| POST | `/agent/v1/api/projects/{id}/pretake/dissolve/check` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/pretake/dissolve/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/projects/{id}/pretake/dissolve/retake` | paid (credits held first) |  |

### take-gate: before Generate a take's hold, free

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/pretake/gate` | free |  |

### take-match-routes: the take-match check, switched off

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/pretake/match` | free |  |
| POST | `/agent/v1/api/projects/{id}/pretake/match` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/pretake/match/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/projects/{id}/pretake/match/switch` | paid (credits held first) |  |

### motion-check-routes: quote, run, the latest per take, the automatic setting

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/pretake/motion` | free |  |
| POST | `/agent/v1/api/projects/{id}/pretake/motion` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/pretake/motion/auto` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/pretake/motion/quote` | quote (free; nothing held) |  |

### pretake-notes-routes: Real / Noise, acted / ignored, the rate

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/pretake/notes` | free |  |
| POST | `/agent/v1/api/projects/{id}/pretake/notes/mark` | free |  |
| POST | `/agent/v1/api/projects/{id}/pretake/notes/outcome` | free |  |
| GET | `/agent/v1/api/projects/{id}/pretake/notes/rate` | free |  |

### pretake-recheck: only the remade keyframes

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/pretake/recheck` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/pretake/recheck/quote` | quote (free; nothing held) |  |

### still-check

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/pretake/still` | free |  |
| POST | `/agent/v1/api/projects/{id}/pretake/still` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/pretake/still/decision` | free |  |
| POST | `/agent/v1/api/projects/{id}/pretake/still/quote` | quote (free; nothing held) |  |
| GET | `/agent/v1/api/projects/{id}/pretake/still/states` | free |  |

### questions-routes: the open questions (Check script, the writer's, Check shot list's notes) and their answers (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/questions` | free |  |
| POST | `/agent/v1/api/projects/{id}/questions/answer` | free |  |

### remake-limit-routes: the setting in force, the spend, a verdict

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/remake-limits` | free |  |
| POST | `/agent/v1/api/projects/{id}/remake-limits/check` | free |  |

### renders-routes: GET the finished renders (any member)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/renders` | free |  |

### render-stop: POST /:jobId/stop, editors, free

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/renders/{jobId}/stop` | free |  |

### content-research-routes

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/research-brief` | free |  |

### rights: the rights question's switch (off)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/rights` | free |  |
| GET | `/agent/v1/api/projects/{id}/rights/log` | free |  |
| GET | `/agent/v1/api/rights` | free |  |

### screener-routes: list, make (the link once), revoke, views; free

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/screeners` | free |  |
| GET | `/agent/v1/api/projects/{id}/screeners/{sid}/views` | free |  |

### sfx-routes: effects and ambience, quote first, with {kind: "effects" or "ambience", text, start, end} in seconds of the cut, then maxCredits; the sounds the script names

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/sfx` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/sfx/quote` | quote (free; nothing held) |  |
| GET | `/agent/v1/api/projects/{id}/sfx/scripted` | free |  |
| POST | `/agent/v1/api/projects/{id}/sfx/scripted/find` | free |  |

### prompt-shorten-routes: Shorten and make's shortening (quote free, the call paid)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/shorten` | free |  |
| POST | `/agent/v1/api/projects/{id}/shorten` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/shorten/quote` | quote (free; nothing held) |  |

### project-store-routes: History's copies beside the project, the read cache (on), the copies back

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/shot-log/copies` | free | a read: History lines' copies for their Undo (0.68.5) |

### scene-notes-routes: GET, PUT: which scenes' notes boxes this person hid on the Shot List (their settings, free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/shotlist/notes` | free |  |
| PUT | `/agent/v1/api/projects/{id}/shotlist/notes` | free |  |

### shot-chat: the Shot List's chat and review

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/shots/chat` | paid (credits held first) |  |
| GET | `/agent/v1/api/projects/{id}/shots/chat/{pending}` | free |  |
| POST | `/agent/v1/api/projects/{id}/shots/chat/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/projects/{id}/shots/check` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/shots/check/quote` | quote (free; nothing held) |  |

### sound-only: GET, POST /quote (free), POST (paid), POST /picture (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/sound-only` | free |  |
| POST | `/agent/v1/api/projects/{id}/sound-only` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/sound-only/picture` | free |  |
| POST | `/agent/v1/api/projects/{id}/sound-only/quote` | quote (free; nothing held) |  |

### breakdown

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/story/breakdown` | free |  |
| POST | `/agent/v1/api/projects/{id}/story/breakdown` | free |  |

### story

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/story/chat` | paid (credits held first) |  |
| GET | `/agent/v1/api/projects/{id}/story/chat/{pending}` | free |  |
| POST | `/agent/v1/api/projects/{id}/story/check` | free |  |
| GET | `/agent/v1/api/projects/{id}/story/export/{file}` | free |  |
| POST | `/agent/v1/api/projects/{id}/story/import` | free |  |
| POST | `/agent/v1/api/projects/{id}/story/quote` | quote (free; nothing held) |  |
| GET | `/agent/v1/api/projects/{id}/story/report` | free |  |

### script-coverage

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/story/coverage` | paid (credits held first) |  |
| GET | `/agent/v1/api/projects/{id}/story/coverage/{index}.pdf` | free |  |
| POST | `/agent/v1/api/projects/{id}/story/coverage/quote` | quote (free; nothing held) |  |

### coverage-brainstorm-routes

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/story/coverage/brainstorm` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/story/coverage/brainstorm/quote` | quote (free; nothing held) |  |

### storyboard-routes: the paper edit, describe a shot, batch Make, two models

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/storyboard` | free |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/batch/plan` | free |  |
| GET | `/agent/v1/api/projects/{id}/storyboard/compare` | free |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/compare` | free |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/describe-shot` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/describe-shot/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/paper-edit` | free |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/paper-edit/propose` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/paper-edit/propose/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/shots` | free |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/split` | free |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/split/dismiss` | free |  |

### cut-reply-routes: Reply on a cut's offer: its quote and its paid answer

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/storyboard/cut-reply` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/cut-reply/quote` | quote (free; nothing held) |  |

### help-draft-routes: Help draft's quote and its paid new version

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/storyboard/help-draft` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/help-draft/quote` | quote (free; nothing held) |  |
| GET | `/agent/v1/api/projects/{id}/storyboard/help-draft/thread` | free |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/help-draft/thread` | free |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/help-draft/thread/start-over` | free |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/help-draft/thread/undo-start-over` | free |  |

### move-end-reply-routes: Reply on a move's end: its quote and its paid answer

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/storyboard/move-end/reply` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/move-end/reply/quote` | quote (free; nothing held) |  |

### board-make-routes: the new-shot panel's quote, Make it, the waiting stills

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/storyboard/panels/makes` | free |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/panels/quote` | quote (free; nothing held) |  |

### plan-routes: OK the plan, Keep (free), Remake them (paid, its quote free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/storyboard/plan/changes/{changeId}/undo` | free |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/plan/keep` | free |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/plan/places/{placeId}/ok` | free |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/plan/places/{placeId}/ok/undo` | free |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/plan/places/{placeId}/skip` | free |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/plan/places/{placeId}/skip/undo` | free |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/plan/remake` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/plan/remake/quote` | quote (free; nothing held) |  |

### plan2-routes: Make this plate, the plan drawn from words (paid, quotes free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/storyboard/plan/draw` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/plan/draw/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/plan/plate` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/storyboard/plan/plate/quote` | quote (free; nothing held) |  |

### style-routes: PUT / (free), POST /write (free), /brainstorm/quote, /brainstorm (paid), /palette (free), /remake/quote, /remake (paid)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| PUT | `/agent/v1/api/projects/{id}/style` | free |  |
| POST | `/agent/v1/api/projects/{id}/style/brainstorm` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/style/brainstorm/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/projects/{id}/style/palette` | free |  |
| POST | `/agent/v1/api/projects/{id}/style/remake` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/style/remake/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/projects/{id}/style/write` | free |  |

### agent-cuts: GET /take-sheet/:takeId, POST /cut-list (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/take-sheet/{takeId}` | free |  |

### take-whole-routes: a shot's takes of the whole shot, remake a part, Try again, join

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/takes/{takeId}/remake` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/takes/{takeId}/remake/quote` | quote (free; nothing held) |  |
| POST | `/agent/v1/api/projects/{id}/takes/join` | free |  |
| POST | `/agent/v1/api/projects/{id}/takes/retry` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/takes/retry/quote` | quote (free; nothing held) |  |
| GET | `/agent/v1/api/projects/{id}/takes/whole` | free |  |
| POST | `/agent/v1/api/projects/{id}/takes/whole/{group}/cancel` | free |  |

### theirs-routes: GET, PUT: "You're editing Costa's project. Duplicate the board?", once per project per person (their settings, free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/theirs` | free |  |
| PUT | `/agent/v1/api/projects/{id}/theirs` | free |  |

### production-tools: Propose coverage; for a scene of title cards only at BLACK, generate answers 200 { status: "cards-only", data: [] } with no id, and nothing is quoted, held or charged

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/tools/frame` | free |  |
| POST | `/agent/v1/api/projects/{id}/tools/lut` | free |  |
| GET | `/agent/v1/api/projects/{id}/tools/proposals` | free |  |
| POST | `/agent/v1/api/projects/{id}/tools/proposals/{action}` | paid (credits held first) |  |
| GET | `/agent/v1/api/projects/{id}/tools/proposals/{proposal}` | free |  |
| POST | `/agent/v1/api/projects/{id}/tools/proposals/{proposal}/review` | free |  |

### media-uploads: POST, PUT /:uploadId/parts/:n, POST /:uploadId/finish, DELETE /:uploadId (free; /media below is unchanged)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/uploads` | free |  |
| POST | `/agent/v1/api/projects/{id}/uploads/{uploadId}/finish` | free |  |
| PUT | `/agent/v1/api/projects/{id}/uploads/{uploadId}/parts/{n}` | free |  |

### vertical-routes: GET/POST /renders/:jobId, PUT /centers; free

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| PUT | `/agent/v1/api/projects/{id}/vertical/centers` | free |  |
| GET | `/agent/v1/api/projects/{id}/vertical/renders/{jobId}` | free |  |
| POST | `/agent/v1/api/projects/{id}/vertical/renders/{jobId}` | free |  |

### viewfinder-routes: read a framing and its sketch; start, camera, people, line, last frame, new shots, the page's ops (free)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/viewfinder/{sceneId}` | free |  |
| POST | `/agent/v1/api/projects/{id}/viewfinder/{sceneId}/ops` | free |  |
| PATCH | `/agent/v1/api/projects/{id}/viewfinder/{sceneId}/people/{tag}` | free |  |
| POST | `/agent/v1/api/projects/{id}/viewfinder/{sceneId}/people/{tag}/match` | free |  |
| POST | `/agent/v1/api/projects/{id}/viewfinder/{sceneId}/people/{tag}/move` | free |  |
| POST | `/agent/v1/api/projects/{id}/viewfinder/{sceneId}/shots` | free |  |
| POST | `/agent/v1/api/projects/{id}/viewfinder/{sceneId}/shots/{draftId}/send` | free |  |
| GET | `/agent/v1/api/projects/{id}/viewfinder/{sceneId}/shots/{shotId}` | free |  |
| PATCH | `/agent/v1/api/projects/{id}/viewfinder/{sceneId}/shots/{shotId}/camera` | free |  |
| POST | `/agent/v1/api/projects/{id}/viewfinder/{sceneId}/shots/{shotId}/last-frame` | free |  |
| POST | `/agent/v1/api/projects/{id}/viewfinder/{sceneId}/shots/{shotId}/line` | free |  |
| PATCH | `/agent/v1/api/projects/{id}/viewfinder/{sceneId}/shots/{shotId}/people/{tag}` | free |  |
| POST | `/agent/v1/api/projects/{id}/viewfinder/{sceneId}/shots/{shotId}/sketch` | free |  |
| POST | `/agent/v1/api/projects/{id}/viewfinder/{sceneId}/shots/{shotId}/start` | free |  |

### voice

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| POST | `/agent/v1/api/projects/{id}/voice` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/voice/quote` | quote (free; nothing held) |  |

### voice-over: GET, POST /quote (free), POST (paid)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/voice-over` | free |  |
| POST | `/agent/v1/api/projects/{id}/voice-over` | paid (credits held first) |  |
| POST | `/agent/v1/api/projects/{id}/voice-over/quote` | quote (free; nothing held) |  |

### wip-routes: GET, PUT /:tabId, POST /:tabId/discard|restore: the filmmaker's Work in progress tabs (free, their own)

| Method | Path | Money | Only |
| --- | --- | --- | --- |
| GET | `/agent/v1/api/projects/{id}/wip` | free |  |
| PUT | `/agent/v1/api/projects/{id}/wip/{tabId}` | free |  |
| POST | `/agent/v1/api/projects/{id}/wip/{tabId}/discard` | free |  |
| POST | `/agent/v1/api/projects/{id}/wip/{tabId}/restore` | free |  |

## Reached only through a tool (11)

These routes build their request as the page does, so an agent calls the tool, not the route. A call at the door is refused with the tool's name.

| Method | Route | The tool | Why |
| --- | --- | --- | --- |
| POST | `/api/projects` | `create_project` |  |
| POST | `/api/projects/:id/assets/:assetId/set-pack` | none from outside | the Tarkovsky Director's make tool; no outside tool makes a set pack yet |
| POST | `/api/projects/:id/cut-list` | `set_cuts` |  |
| GET | `/api/projects/:id/director` | `get_run` |  |
| POST | `/api/projects/:id/director/estimate` | `estimate_film` |  |
| POST | `/api/projects/:id/director/resume` | `resume_run` |  |
| GET | `/api/projects/:id/director/runs/:rid/log` | `get_run` |  |
| POST | `/api/projects/:id/director/start` | `start_run` |  |
| POST | `/api/projects/:id/director/stop` | `stop_run` |  |
| POST | `/api/projects/:id/storyboard/batch` | `make_still`, `make_take` | one still or take at a time, through make_still and make_take |
| POST | `/api/projects/:id/storyboard/panels/make` | `make_still` | the new shot's still through make_still |

## The filmmaker's own (402)

Refused to every agent, at the door and through `studio_request`, with the reason below. The filmmaker does these in the studio.

### The account, its keys, agent links, agreements and email are the filmmaker's.

- `GET /api/account/agent-links`
- `POST /api/account/agent-links`
- `PUT /api/account/agent-links/:id`
- `POST /api/account/agent-links/:id/restore`
- `GET /api/account/agreements`
- `POST /api/account/agreements`
- `PUT /api/account/agreements/improve`
- `GET /api/account/ask-window`
- `PUT /api/account/ask-window`
- `GET /api/account/email`
- `PUT /api/account/email`
- `GET /api/account/licences/minimax-h3`
- `POST /api/account/licences/minimax-h3`
- `GET /api/account/members`
- `PUT /api/account/members`
- `POST /api/account/members/invite`
- `GET /api/contacts`
- `POST /api/contacts`
- `PUT /api/contacts/:id`
- `GET /api/keys`
- `PUT /api/keys/:provider`

### An agent deletes nothing (DELETE is the filmmaker's, in the studio).

- `DELETE /api/account/agent-links/:id`
- `DELETE /api/account/members`
- `DELETE /api/admin/content-research/secrets/:name`
- `DELETE /api/admin/social-apps/:app`
- `DELETE /api/admin/youtube-setup`
- `DELETE /api/gallery/series/:seriesId`
- `DELETE /api/keys/:provider`
- `DELETE /api/projects/:id/ask-takes/:rowId`
- `DELETE /api/projects/:id/assets/:assetId/pictures/:imageId`
- `DELETE /api/projects/:id/budget/share`
- `DELETE /api/projects/:id/chat`
- `DELETE /api/projects/:id/exports/set-asides/:sid`
- `DELETE /api/projects/:id/floor-plans/:sceneId`
- `DELETE /api/projects/:id/kickoff/script/auto`
- `DELETE /api/projects/:id/members`
- `DELETE /api/projects/:id/packages/:pid/listings/:listingId`
- `DELETE /api/projects/:id/places/:placeId/joins/:joinId`
- `POST /api/projects/:id/removed/still`
- `POST /api/projects/:id/removed/take`
- `DELETE /api/projects/:id/sequences/:sid`
- `DELETE /api/projects/:id/uploads/:uploadId`
- `DELETE /api/projects/:id/viewfinder/:sceneId/shots/:draftId`
- `DELETE /api/projects/:id/viewfinder/:sceneId/shots/:shotId/last-frame`

### Administration is the studio's staff's, never an agent's.

- `POST /api/admin-invitations/accept`
- `GET /api/admin/access`
- `GET /api/admin/accounts/duplicates`
- `POST /api/admin/accounts/duplicates/link`
- `GET /api/admin/agent-runs`
- `POST /api/admin/agent-runs/problems/:problem/approve`
- `PUT /api/admin/agent-runs/settings`
- `GET /api/admin/anatomy`
- `PUT /api/admin/anatomy`
- `GET /api/admin/anatomy/jobs/:jobId`
- `GET /api/admin/answers-in-prompts`
- `PUT /api/admin/answers-in-prompts`
- `GET /api/admin/assistant`
- `PUT /api/admin/assistant`
- `GET /api/admin/caps`
- `PUT /api/admin/caps/:key`
- `GET /api/admin/caps/usage`
- `GET /api/admin/cards`
- `POST /api/admin/cards`
- `GET /api/admin/cheapest-still-model`
- `POST /api/admin/cheapest-still-model`
- `GET /api/admin/commissions`
- `POST /api/admin/commissions/:id/access-restored`
- `POST /api/admin/commissions/:id/approve`
- `POST /api/admin/commissions/:id/authorize`
- `POST /api/admin/commissions/:id/balance-received`
- `POST /api/admin/commissions/:id/cancel`
- `GET /api/admin/commissions/:id/cancel-preview`
- `POST /api/admin/commissions/:id/change`
- `POST /api/admin/commissions/:id/change/withdraw`
- `POST /api/admin/commissions/:id/check`
- `POST /api/admin/commissions/:id/close`
- `POST /api/admin/commissions/:id/decline`
- `POST /api/admin/commissions/:id/defect`
- `POST /api/admin/commissions/:id/defect-refuse`
- `POST /api/admin/commissions/:id/quote`
- `POST /api/admin/commissions/:id/review-copy`
- `GET /api/admin/commissions/flow`
- `GET /api/admin/commissions/onboarding`
- `POST /api/admin/commissions/onboarding/:userId`
- `GET /api/admin/commissions/records/:id`
- `POST /api/admin/commissions/refunds/:refundId/made`
- `POST /api/admin/commissions/refunds/:refundId/retry`
- `POST /api/admin/commissions/shares/:shareId/paid`
- `GET /api/admin/compute`
- `POST /api/admin/content-research/candidates/:storyId/review`
- `GET /api/admin/content-research/catalog`
- `POST /api/admin/content-research/catalog/editions`
- `GET /api/admin/content-research/channel`
- `PUT /api/admin/content-research/channel`
- `POST /api/admin/content-research/channel/autopilot`
- `POST /api/admin/content-research/channel/run-now`
- `GET /api/admin/content-research/commissions`
- `POST /api/admin/content-research/commissions`
- `POST /api/admin/content-research/commissions/:id/create-project`
- `POST /api/admin/content-research/commissions/:id/link-publication`
- `POST /api/admin/content-research/commissions/:id/stop`
- `GET /api/admin/content-research/connections`
- `PUT /api/admin/content-research/connections/:key`
- `GET /api/admin/content-research/profiles`
- `POST /api/admin/content-research/profiles`
- `PATCH /api/admin/content-research/profiles/:id`
- `GET /api/admin/content-research/results`
- `POST /api/admin/content-research/results/import`
- `GET /api/admin/content-research/runs`
- `POST /api/admin/content-research/runs`
- `GET /api/admin/content-research/runs/:id`
- `POST /api/admin/content-research/runs/:id/cancel`
- `POST /api/admin/content-research/runs/:id/import-trends`
- `GET /api/admin/content-research/runs/:id/report.txt`
- `POST /api/admin/content-research/runs/quote`
- `PUT /api/admin/content-research/secrets/:name`
- `GET /api/admin/continuity-critic`
- `POST /api/admin/continuity-critic`
- `GET /api/admin/critic`
- `GET /api/admin/critic/agreement`
- `POST /api/admin/critic/draft`
- `POST /api/admin/critic/draft/quote`
- `GET /api/admin/critic/drafts`
- `GET /api/admin/critic/marks`
- `PUT /api/admin/critic/marks`
- `GET /api/admin/critic/passes`
- `GET /api/admin/critic/passes/:id`
- `PUT /api/admin/critic/passes/:id/reference`
- `GET /api/admin/critic/references`
- `GET /api/admin/critic/vault`
- `GET /api/admin/critic/vault/block`
- `GET /api/admin/critic/vault/built-in`
- `POST /api/admin/critic/vault/entries`
- `GET /api/admin/critic/vault/entries/:slug`
- `PUT /api/admin/critic/vault/entries/:slug`
- `POST /api/admin/critic/vault/entries/:slug/archive`
- `POST /api/admin/critic/vault/entries/:slug/restore`
- `GET /api/admin/critic/vault/releases`
- `PUT /api/admin/critic/vault/switch`
- `GET /api/admin/dailies-critic`
- `POST /api/admin/dailies-critic`
- `GET /api/admin/director`
- `PUT /api/admin/director`
- `GET /api/admin/director-thinking-room`
- `POST /api/admin/director-thinking-room`
- `PUT /api/admin/director/critic`
- `GET /api/admin/director/endpoints`
- `PUT /api/admin/director/endpoints`
- `GET /api/admin/director/shot-by-shot`
- `PUT /api/admin/director/shot-by-shot`
- `GET /api/admin/director/shot-by-shot/projects/:pid`
- `PUT /api/admin/director/shot-by-shot/projects/:pid`
- `GET /api/admin/export`
- `GET /api/admin/frame-sketch`
- `POST /api/admin/frame-sketch`
- `GET /api/admin/frame-sketch/stills`
- `GET /api/admin/frame-sketch/stills/:jobId/:which`
- `GET /api/admin/gallery`
- `POST /api/admin/gallery/:listingId/feature`
- `POST /api/admin/gallery/:listingId/publish`
- `POST /api/admin/gallery/:listingId/remove`
- `POST /api/admin/gallery/:listingId/restore`
- `GET /api/admin/gallery/listings`
- `GET /api/admin/gallery/payouts`
- `POST /api/admin/gallery/payouts/:id/resolve`
- `POST /api/admin/gallery/payouts/run`
- `GET /api/admin/gallery/reports`
- `POST /api/admin/gallery/reports/:reportId/dismiss`
- `POST /api/admin/gallery/reports/:reportId/remove`
- `POST /api/admin/gallery/switches/:key`
- `POST /api/admin/holds/:id/release`
- `POST /api/admin/invitations`
- `POST /api/admin/invitations/:invite/revoke`
- `GET /api/admin/job-sweep`
- `PUT /api/admin/job-sweep`
- `GET /api/admin/lock-relabel`
- `POST /api/admin/lock-relabel`
- `GET /api/admin/long-scripts`
- `PUT /api/admin/long-scripts`
- `GET /api/admin/media-cdn`
- `PUT /api/admin/media-cdn`
- `POST /api/admin/media-cdn/check`
- `POST /api/admin/members/:member/revoke`
- `GET /api/admin/minimax-h3-flash`
- `PUT /api/admin/minimax-h3-flash`
- `GET /api/admin/model-accounts`
- `POST /api/admin/model-accounts`
- `PUT /api/admin/model-accounts/:id`
- `POST /api/admin/model-accounts/:id/archive`
- `POST /api/admin/model-accounts/:id/refresh`
- `POST /api/admin/model-accounts/:id/reveal`
- `POST /api/admin/model-accounts/import-env`
- `GET /api/admin/overview`
- `GET /api/admin/platform-keys`
- `POST /api/admin/platform-keys/read`
- `PUT /api/admin/platform-keys/settings`
- `GET /api/admin/production`
- `POST /api/admin/production/asks/:askId/answered`
- `POST /api/admin/production/jobs/:id/unbind`
- `PUT /api/admin/production/makers`
- `PUT /api/admin/production/models`
- `GET /api/admin/prompt-versions`
- `POST /api/admin/prompt-versions`
- `GET /api/admin/refs-switches`
- `POST /api/admin/refs-switches`
- `GET /api/admin/render-farm`
- `PUT /api/admin/render-farm/boards`
- `PUT /api/admin/render-farm/export-rates`
- `PUT /api/admin/render-farm/fade-from-black`
- `PUT /api/admin/render-farm/frame-rates`
- `POST /api/admin/render-farm/stop`
- `PUT /api/admin/render-farm/switch`
- `GET /api/admin/reports`
- `GET /api/admin/reports/:id`
- `POST /api/admin/reports/:id/answer`
- `POST /api/admin/reports/:id/linear`
- `POST /api/admin/reports/:id/triage`
- `GET /api/admin/retake-fresh-refs`
- `POST /api/admin/retake-fresh-refs`
- `GET /api/admin/rights`
- `POST /api/admin/rights/names`
- `POST /api/admin/rights/switch`
- `GET /api/admin/sample-film`
- `PUT /api/admin/sample-film`
- `GET /api/admin/scope-switches`
- `PUT /api/admin/scope-switches`
- `GET /api/admin/sketch`
- `POST /api/admin/sketch/projects/:id`
- `GET /api/admin/social-apps`
- `PUT /api/admin/social-apps/:app`
- `PUT /api/admin/social-apps/switch/:platform`
- `GET /api/admin/speed`
- `PUT /api/admin/speed/:key`
- `POST /api/admin/speed/copies-back`
- `GET /api/admin/studio-key`
- `POST /api/admin/studio-key/read`
- `POST /api/admin/studio-key/runs/:id/reopen`
- `PUT /api/admin/studio-key/settings`
- `GET /api/admin/titles`
- `POST /api/admin/titles`
- `GET /api/admin/titles3`
- `POST /api/admin/titles3`
- `GET /api/admin/uncapped`
- `PUT /api/admin/uncapped`
- `GET /api/admin/uncapped/users/:id`
- `PUT /api/admin/uncapped/users/:id`
- `GET /api/admin/users`
- `GET /api/admin/users/:id`
- `PUT /api/admin/users/:id`
- `POST /api/admin/users/:id/credits`
- `GET /api/admin/users/:id/deletion`
- `POST /api/admin/users/:id/deletion`
- `PUT /api/admin/users/:id/plan`
- `PUT /api/admin/users/:id/storage`
- `GET /api/admin/vault`
- `GET /api/admin/vault/block`
- `GET /api/admin/vault/built-in`
- `POST /api/admin/vault/entries`
- `GET /api/admin/vault/entries/:slug`
- `PUT /api/admin/vault/entries/:slug`
- `POST /api/admin/vault/entries/:slug/archive`
- `POST /api/admin/vault/entries/:slug/restore`
- `GET /api/admin/vault/releases`
- `PUT /api/admin/vault/switch`
- `GET /api/admin/vertical-cut`
- `PUT /api/admin/vertical-cut`
- `GET /api/admin/video-models`
- `GET /api/admin/welcome-email`
- `POST /api/admin/welcome-email/switch`
- `POST /api/admin/welcome-email/test`
- `GET /api/admin/youtube-setup`
- `PUT /api/admin/youtube-setup`

### Purchases, top-ups, earnings and payouts are the filmmaker's, on the site.

- `POST /api/billing/auto-topup`
- `POST /api/billing/auto-topup/off`
- `POST /api/billing/card`
- `POST /api/billing/card/remove`
- `POST /api/billing/checkout`
- `POST /api/billing/portal`
- `GET /api/gallery/access/:listingId`
- `GET /api/gallery/access/series/:seriesId`
- `POST /api/gallery/buy`
- `POST /api/gallery/connect`
- `POST /api/gallery/connect/webhook`
- `GET /api/gallery/earnings`
- `PUT /api/gallery/listings/:id/price`
- `GET /api/gallery/money/project/:projectId`
- `GET /api/gallery/money/status`
- `POST /api/gallery/tip`

### Outside the projects, only the session, billing, the model catalogs and the free quotes are open to an agent.

- `POST /api/billing/plan`
- `POST /api/billing/plan/quote`
- `POST /api/billing/refresh`
- `GET /api/boot`
- `POST /api/client-crash`
- `POST /api/help/chat`
- `GET /api/models/:provider`
- `PUT /api/models/defaults`
- `POST /api/palette/file`
- `POST /api/palette/words`
- `POST /api/reports`
- `GET /api/reports/:id/screenshot`
- `POST /api/reports/:id/seen`
- `GET /api/reports/mine`
- `GET /api/self-hosted/status`
- `GET /api/social/callback/:app`
- `GET /api/social/channels`
- `PATCH /api/social/channels/:id`
- `POST /api/social/channels/:id/disconnect`
- `GET /api/social/channels/:id/tiktok`
- `POST /api/social/connect`
- `POST /api/social/posts`
- `POST /api/social/posts/:id/cancel`
- `POST /api/social/posts/:id/take-down`
- `GET /api/social/project/:projectId`
- `POST /api/social/renders/:mediaId/final`
- `POST /api/social/uploads/:id/resume`

### Messages to people outside the studio are the filmmaker's.

- `POST /api/contact`

### Publishing to the Gallery, its listings, packages and screener links are the filmmaker's.

- `GET /api/gallery/commissions`
- `POST /api/gallery/commissions`
- `GET /api/gallery/commissions/:id`
- `POST /api/gallery/commissions/:id/accept`
- `POST /api/gallery/commissions/:id/access`
- `POST /api/gallery/commissions/:id/approve`
- `POST /api/gallery/commissions/:id/balance`
- `POST /api/gallery/commissions/:id/cancel`
- `POST /api/gallery/commissions/:id/changes/decline`
- `POST /api/gallery/commissions/:id/decline`
- `POST /api/gallery/commissions/:id/deliver`
- `GET /api/gallery/commissions/:id/delivery`
- `POST /api/gallery/commissions/:id/deposit`
- `POST /api/gallery/commissions/:id/revise`
- `GET /api/gallery/commissions/business`
- `PUT /api/gallery/commissions/business`
- `PUT /api/gallery/commissions/open`
- `GET /api/gallery/commissions/records`
- `GET /api/gallery/commissions/records/:id`
- `GET /api/gallery/commissions/statement`
- `GET /api/gallery/commissions/terms-text`
- `GET /api/gallery/follow`
- `POST /api/gallery/follow`
- `POST /api/gallery/fork/:listingId`
- `POST /api/gallery/listings/:id/hide`
- `POST /api/gallery/listings/:id/private`
- `POST /api/gallery/listings/:id/private/link`
- `POST /api/gallery/listings/:id/private/off`
- `PUT /api/gallery/listings/:id/private/password`
- `POST /api/gallery/listings/:id/private/previews`
- `POST /api/gallery/listings/:id/private/previews/:linkId/revoke`
- `POST /api/gallery/listings/:id/private/update`
- `POST /api/gallery/listings/:id/show`
- `GET /api/gallery/me`
- `PUT /api/gallery/me`
- `GET /api/gallery/mine`
- `GET /api/gallery/private`
- `GET /api/gallery/producer`
- `POST /api/gallery/producer`
- `PUT /api/gallery/producer/details`
- `GET /api/gallery/producer/text`
- `GET /api/gallery/production/:id`
- `POST /api/gallery/production/:id/ask`
- `GET /api/gallery/production/:id/delivery-check`
- `POST /api/gallery/production/:id/project`
- `GET /api/gallery/production/:id/provenance`
- `POST /api/gallery/report/:listingId`
- `GET /api/gallery/series`
- `POST /api/gallery/series`
- `PUT /api/gallery/series/:seriesId`
- `GET /api/gallery/viewer/:listingId`
- `GET /api/gallery/youtube`
- `GET /api/gallery/youtube/callback`
- `POST /api/gallery/youtube/connect`
- `POST /api/gallery/youtube/disconnect`
- `POST /api/gallery/youtube/upload`
- `POST /api/gallery/youtube/uploads/:id/resume`
- `POST /api/projects/:id/gallery`
- `PUT /api/projects/:id/gallery/:listingId`
- `POST /api/projects/:id/gallery/:listingId/poster`
- `POST /api/projects/:id/gallery/:listingId/preview`
- `POST /api/projects/:id/gallery/:listingId/submit`
- `POST /api/projects/:id/gallery/:listingId/unpublish`
- `POST /api/projects/:id/packages`
- `PUT /api/projects/:id/packages/:pid/listings/:listingId`
- `POST /api/projects/:id/screeners`
- `POST /api/projects/:id/screeners/:sid/revoke`

### Only a filmmaker answers a flag.

- `POST /api/projects/:id/agent/flags/answer`

### An agent run (its decision log and report) is opened and finished by Tarkovsky Director or the filmmaker in the studio; an outside agent's calls are kept on its link.

- `POST /api/projects/:id/agent/runs`
- `POST /api/projects/:id/agent/runs/:run/finish`

### Members, sharing, invitations, archiving and copies are the filmmaker's.

- `POST /api/projects/:id/archive`
- `PUT /api/projects/:id/budget/share`
- `POST /api/projects/:id/duplicate`
- `GET /api/projects/:id/members`
- `PUT /api/projects/:id/members`
- `POST /api/projects/:id/members/invite`

### Marks on the Critic's notes are a person's word on them.

- `GET /api/projects/:id/critic/marks`
- `PUT /api/projects/:id/critic/marks`

### The Director's own routes are its tools' (start_run, get_run, stop_run, resume_run, estimate_film).

- `GET /api/projects/:id/director/runs/:rid/flags`
- `GET /api/projects/:id/director/runs/:rid/report.pdf`
- `POST /api/projects/:id/director/runs/:rid/shots/:shotId/again`

### The kickoff's synopsis and concept buttons are the filmmaker's; POST /kickoff/script writes them first, within your budget.

- `POST /api/projects/:id/kickoff/concept`
- `POST /api/projects/:id/kickoff/synopsis`

### Confirming the rights to a picture is the filmmaker's own word.

- `POST /api/projects/:id/rights/brief`
- `POST /api/projects/:id/rights/media/:mediaId`
- `POST /api/projects/:id/rights/person`

## How this page stays current

This page is written from the code that serves the API, at version 0.72: the tools, the route list, the scopes and the limits. The route list is read from the app itself, and a new route that isn't classed open, tool or the filmmaker's fails the build. This page and its Markdown twin are written again with every release, and the build fails while they differ from the code (AGENTS.md §7).
