---
title: "Register a separate source track"
method: POST
path: "/api/task-creations/{id}/takes/{takeId}/tracks"
---

# Register a separate source track

`POST /api/task-creations/{id}/takes/{takeId}/tracks`

## Request

- Base URL: `https://www.toma.com`
- URL: `https://www.toma.com/api/task-creations/{id}/takes/{takeId}/tracks`
- 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

## Request body

- object
  - `kind` 'screen' | 'camera' | 'microphone' | 'shared_audio', required
  - `facing` 'user' | 'environment'
  - `mimeType` 'video/webm' | 'video/mp4' | 'audio/webm' | 'audio/mp4' | 'audio/wav' | 'audio/pcm' | 'audio/x-pcm-f32le', required
  - `offsetMs` number
  - `sampleRate` integer
  - `channels` integer

## Response `200`

Track id and nextSequence (zero).

- object
  - `id` string
  - `nextSequence` integer

## 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.
- `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)