---
title: "Creates a new segment."
method: POST
path: "/api/v2/segments"
tags: ["Segments"]
---

# Creates a new segment.

`POST /api/v2/segments`

## Response `201`

The created segment with fields populated.

- Segment — An audio segment in an episode.
  - `id` integer — The unique ID of the segment. Generated at creation.
  - `episodeId` integer, required — The ID of the episode that owns the segment.
  - `segmentNumber` integer, required — The number of the segment in the episode, starting with 1.
  - `inCue` string — The in-cue copy that signals the start of the segment to a board operator.
  - `outCue` string — The out-cue copy that signals the end of the segment to a board operator.
  - `createdDate` string, date-time — The date the segment was created in ISO 8601 format. Generated at creation.
  - `lastModifiedDate` string, date-time — The date the segment was last modified/updated in ISO 8601 format. Automatically updated on any write operation.
  - `length` integer — The length (duration) of the segment in seconds.
  - `channels` integer — The number of audio channels in the segment. Generated at creation.
  - `fileSize` integer — The size of the audio content file in bytes. Generated at creation.
  - `fileName` string — The name of the audio content file. Generated at creation.
  - `originalFileName` string — The original name of the audio content file.

## Other responses

- `400` — The request is missing required data or invalid.
- `403` — Authorization failed, or the user is not permitted to create the segment.
- `404` — The information for creating the segment cannot be found.

---

[API](https://skmtc.net/prss/apis/contentdepot.md) · [All operations](https://skmtc.net/prss/apis/contentdepot/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prss/contentdepot/versions/838e7ae589d8/schema)