Docs
Log inStart free
API referenceProjects

The beat grid

The project tempo as plain JSON on the film clock: bars [bar, sec], beats [sec, bar, beat], tempo sections, the music beds with their feature files, and the feature channel names.

grid is null for a project with no tempo. Free.

GET
/projects/{id}/beat-grid

Authorization

bearerAuth
AuthorizationBearer <token>

Typecut API key. Generate one in app.typecut.ai → Settings → API keys. Send as Authorization: Bearer tc_live_….

In: header

Path Parameters

id*string
Formatuuid

Query Parameters

from?string
to?string

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/beat-grid"
{
  "data": {}
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

The project map GET

Chapters, blocks and scenes with film windows, briefs, states, and the words heard in each scene on the scene clock as [word, start_sec, end_sec]; the tempo summary; what is left to do.

The film timeline GET

The whole film on ONE clock (film seconds, all chapters end to end): the chapter/scene tree by node path (ch:<id>/sc:<id>/el:<id>) with each scene's window, the tempo map with its sections, and every