Create a new, empty collection of music tracks owned by the caller. Tracks are added afterwards.
Creates an empty collection. Use Add a track to a collection to populate it.
organization_id string required
The organization that owns the collection.
name string required
Human-readable collection name. Must be 1–512 characters.
description string optional
Free-text description of the collection.
cover_track_id string optional
A track id (mtrack_) whose artwork is used as the collection cover.
cover_image_url string optional
A direct image URL for the collection cover. Maximum 1024 characters.
The created collection object.
id string
Collection id, prefixed mcoll_.
name string
The collection name.
description string | null
The collection description, if any.
cover_track_id string | null
The cover track id, if set.
cover_image_url string | null
The cover image URL, if set.
track_count integer
Number of tracks in the collection. 0 for a newly created collection.
created_at string
ISO 8601 creation timestamp.
updated_at string
ISO 8601 last-update timestamp.
- Bash
- Python
- Python
- JavaScript
curl -X POST "https://api.aitronos.com/v1/music/org_abc123/collections" \
-H "X-API-Key: $FREDDY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Focus Sessions",
"description": "Instrumental tracks for deep work"
}'Response:
{
"id": "mcoll_4a1f9c7e2b8d",
"name": "Focus Sessions",
"description": "Instrumental tracks for deep work",
"cover_track_id": null,
"cover_image_url": null,
"track_count": 0,
"created_at": "2026-06-28T10:30:00Z",
"updated_at": "2026-06-28T10:30:00Z"
}