---
title: "Creates a new spot."
method: POST
path: "/api/v2/spots"
tags: ["Spots"]
---

# Creates a new spot.

`POST /api/v2/spots`

## Response `201`

The created spot with fields populated.

- Spot — An audio spot for insertion.
  - `id` integer — The unique ID of the spot. Generated at creation.
  - `name` string — The unique name of the spot
  - `notes` string — Miscellaneous notes about the spot
  - `duration` integer — The length (duration) of the spot in seconds.
  - `lastModifiedDate` string, date-time — The date the spot was last modified/updated in ISO 8601 format. Automatically updated on any write operation.
  - `createdDate` string, date-time — The date the spot was created in ISO 8601 format. Generated at creation.
  - `lastUploadedDate` string, date-time — The date the spot audio file was uploaded in ISO 8601 format. Automatically updated on upload.
  - `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 spot.
- `404` — The information for creating the spot cannot be found.

---

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