API referenceProjects

List the live scene claims in a project

Every live claim (people in the editor and agents), longest-held first.

Lapsed claims are not returned. Empty until the scene_claims migration is applied.

GET
/projects/{id}/claims

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

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/claims"
{
  "data": {
    "claims": [
      {
        "scene_id": "861eef56-1159-4a95-802f-abab2d0cc192",
        "kind": "human",
        "label": "string",
        "since": "string",
        "expires_at": "string",
        "expires_in_s": 0,
        "mine": true
      }
    ]
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}