POST /releases

Headers

Prefer string

Preference

Values are return=representation, return=minimal, return=none, resolution=ignore-duplicates, or resolution=merge-duplicates.

Query parameters

select string

Filtering Columns

Body

releases

catalog_number string(text)

Default value is empty.
created string(timestamp with time zone) Required

Default value is now().
genre string(text)

Default value is empty.
id string(uuid) Required

Note: This is a Primary Key.

Default value is extensions.uuid_generate_v4().
is_compilation boolean(boolean)

Default value is false.
label string(text)

Default value is empty.
release_date string(date)
subgenre string(text)

Default value is empty.
release_title string(text)

Default value is empty.
upc_code string(text)

Default value is empty.
updated string(timestamp with time zone) Required

Default value is now().
release_version string(text)

Default value is empty.
contracts
media_assets
language string(text)

Default value is empty.
tracks
slug string(text)

Default value is empty.
cover_artwork
description string(text)

Default value is empty.
bandcamp string(text)

Default value is empty.
vinyl string(text)

Default value is empty.
org_id string(text)

Default value is empty.
label_id string(uuid)

Note: This is a Foreign Key to labels.id.
genre_id string(uuid)

Note: This is a Foreign Key to genres.id.
subgenre_id string(uuid)

Note: This is a Foreign Key to subgenres.id.

Responses

201

Created

POST /releases

curl \
 --request POST 'https://api.audiokit.ai:443/releases' \
 --header "Prefer: return=representation" \
 --data '{"catalog_number":"","created":"now()","genre":"","id":"extensions.uuid_generate_v4()","is_compilation":false,"label":"","release_date":"2025-05-04","subgenre":"","release_title":"","upc_code":"","updated":"now()","release_version":"","language":"","slug":"","description":"","bandcamp":"","vinyl":"","org_id":"","label_id":"string","genre_id":"string","subgenre_id":"string"}'

Request examples

# Headers
Prefer: return=representation

# Payload
{
  "catalog_number": "",
  "created": "now()",
  "genre": "",
  "id": "extensions.uuid_generate_v4()",
  "is_compilation": false,
  "label": "",
  "release_date": "2025-05-04",
  "subgenre": "",
  "release_title": "",
  "upc_code": "",
  "updated": "now()",
  "release_version": "",
  "language": "",
  "slug": "",
  "description": "",
  "bandcamp": "",
  "vinyl": "",
  "org_id": "",
  "label_id": "string",
  "genre_id": "string",
  "subgenre_id": "string"
}