---
title: "Upload an ordered source chunk"
method: PUT
path: "/api/task-creations/{id}/takes/{takeId}/tracks/{trackId}/chunks/{sequence}"
---

# Upload an ordered source chunk

`PUT /api/task-creations/{id}/takes/{takeId}/tracks/{trackId}/chunks/{sequence}`

## Request

- Base URL: `https://www.toma.com`
- URL: `https://www.toma.com/api/task-creations/{id}/takes/{takeId}/tracks/{trackId}/chunks/{sequence}`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `better-auth.session_token`
  - API key in header `x-task-creation-token`

## Path parameters

- `id` string, required
- `takeId` string, required
- `trackId` string, required
- `sequence` integer, required

## Request body `application/octet-stream`

- string, binary

## Response `200`

Durably stored. Returns nextSequence; identical retries are idempotent.

## Other responses

- `400`: Invalid input.
- `401`: Sign in or use a valid recording capability.
- `404`: Not found, expired, revoked, or owned by another member.
- `409`: The revision, take, upload sequence, or processing state changed. Fetch the current session.
- `413`: Chunk exceeds 4 MB.
- `503`: Processing or storage is unavailable. No publication was made.

---

[API](https://skmtc.dev/toma/apis/toma-api.md) - [All operations](https://skmtc.dev/toma/apis/toma-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toma/apis/toma-api/revisions/b4e56e1db5a2?raw)