---
title: "Start a track versions generation job"
method: POST
path: "/v0/tracks/versions"
tags: ["Beta"]
---

# Start a track versions generation job

`POST /v0/tracks/versions`

This endpoint allows you to start a job to generate edited versions of a track.
The job will be processed asynchronously and you can check the status using the
GET /tracks/versions/{jobId} endpoint. Note that the url expires in 24 hours. 

**Duration limits:**
- The duration must be between 1 second and 5 minutes. 
- Longer durations result in increased processing time, as latency scales with the desired duration.

## Request body

- TrackEditsJobRequest
  - `durationMs` integer, required
  - `trackId` string, uuid, required

## Response `200`

Track edit job response

- TrackEditsResponse
  - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED'
  - `results` TrackEditResultResponse[]
    - `previewUrl` string
    - `waveform` TrackEditWaveform
      - `version` integer
      - `channels` integer
      - `sampleRate` integer
      - `samplesPerPixel` integer
      - `bits` integer
      - `length` integer
      - `data` integer[]
    - `highQualityUrl` string
  - `message` string
  - `jobId` string, uuid

## Other responses

- `400` — Bad request.
- `401` — Unauthorized. Most likely your access token has expired.
- `429` — Rate limit exceeded.

---

[API](https://skmtc.net/epidemicsound/apis/partner-content-api.md) · [All operations](https://skmtc.net/epidemicsound/apis/partner-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epidemicsound/partner-content-api/revisions/c2fa1c98dbc2/schema)