descript

1# Descript
2 
3## Purpose
4Work with Descript's API (open beta): list projects, inspect Underlord/agent jobs, submit a publish job, and poll a job until it finishes. Use when the user wants to drive Descript editing or publishing programmatically.
5 
6## Tooling
7All commands go through `bin/descript.py`:
8 
9```bash
10bin/descript.py auth                                   # verify the API key
11bin/descript.py projects                               # list projects
12bin/descript.py project --id PROJECT_ID                # get one project
13bin/descript.py jobs                                   # list Underlord/agent jobs
14bin/descript.py job-status --id JOB_ID                 # get job status once
15bin/descript.py job-status --id JOB_ID --wait          # poll until job_state is "stopped"
16bin/descript.py publish --project-id PROJECT_ID        # submit a publish job (confirm first)
17bin/descript.py job-delete --id JOB_ID                 # delete a job (confirm first)
18```
19 
20Jobs are async: submit with `publish`, then poll with `job-status --wait` until `job_state` is `stopped`, then check `status` for success/partial/error. The publish body schema follows Descript's API docs; pass `--body` as raw JSON if the default empty body is not enough for your case.
21 
22Auth quirks handled by the CLI: the header name is sent lowercase (`authorization: Bearer <key>`, because a capitalized `Authorization` returns 401) and the key value, which contains a colon, is used whole and never split.
23 
24## Auth
25…