Aden
APIAPI reference

Tracks

Track management — read endpoints available via API key

Search track content, versions, milestones, and todos within a team

GET
/api/v1/tracks/search/deep

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Query Parameters

q*string
teamId*string
limit?string
curl -X GET "https://example.com/api/v1/tracks/search/deep?q=string&teamId=string"

Get Api V1 Tracks

GET
/api/v1/tracks/

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Query Parameters

teamId?string
curl -X GET "https://example.com/api/v1/tracks/"

Create a new idea track with audio upload

POST
/api/v1/tracks/

Authorization

sessionAuth
AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

curl -X POST "https://example.com/api/v1/tracks/" \  -H "Content-Type: application/json" \  -d '{    "title": "string",    "team_id": 0,    "audio_file_name": "string"  }'

Get Api V1 Tracks By Id

GET
/api/v1/tracks/{id}

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
curl -X GET "https://example.com/api/v1/tracks/string"

Update editable track metadata fields

PATCH
/api/v1/tracks/{id}

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

curl -X PATCH "https://example.com/api/v1/tracks/string" \  -H "Content-Type: application/json" \  -d '{}'

Soft-delete (archive) a track

DELETE
/api/v1/tracks/{id}

Authorization

sessionAuth
AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
curl -X DELETE "https://example.com/api/v1/tracks/string"

Get collaborators for a track

GET
/api/v1/tracks/{id}/collaborators

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
curl -X GET "https://example.com/api/v1/tracks/string/collaborators"

Update track status with automatic track_order handling

PATCH
/api/v1/tracks/{id}/status

Authorization

sessionAuth
AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

curl -X PATCH "https://example.com/api/v1/tracks/string/status" \  -H "Content-Type: application/json" \  -d '{    "status": "idea"  }'

Reorder tracks within a status column

POST
/api/v1/tracks/reorder

Authorization

sessionAuth
AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

curl -X POST "https://example.com/api/v1/tracks/reorder" \  -H "Content-Type: application/json" \  -d '{    "status_id": "string",    "track_orders": [      {        "trackId": 0,        "order": 0      }    ]  }'

List all covers for a track

GET
/api/v1/tracks/{id}/covers

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
curl -X GET "https://example.com/api/v1/tracks/string/covers"

Create a new track cover and return presigned upload URL

POST
/api/v1/tracks/{id}/covers

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

curl -X POST "https://example.com/api/v1/tracks/string/covers" \  -H "Content-Type: application/json" \  -d '{    "fileName": "string"  }'

Set a cover as the current track cover

PATCH
/api/v1/tracks/{id}/covers/{coverId}/current

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
coverId*string
curl -X PATCH "https://example.com/api/v1/tracks/string/covers/string/current"

Delete a track cover

DELETE
/api/v1/tracks/{id}/covers/{coverId}

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
coverId*string
curl -X DELETE "https://example.com/api/v1/tracks/string/covers/string"

Create a track version and return a presigned upload URL

POST
/api/v1/tracks/{id}/versions/create

Authorization

sessionAuth
AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

curl -X POST "https://example.com/api/v1/tracks/string/versions/create" \  -H "Content-Type: application/json" \  -d '{    "audio_file_name": "string"  }'

Create an additional audio format for a version and return a presigned upload URL

POST
/api/v1/tracks/{id}/versions/{versionId}/files/create

Authorization

sessionAuth
AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
versionId*string

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

curl -X POST "https://example.com/api/v1/tracks/string/versions/string/files/create" \  -H "Content-Type: application/json" \  -d '{    "audio_file_name": "string"  }'

Get version detail with description, lyrics, and metadata

GET
/api/v1/tracks/{id}/versions/{versionId}/detail

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
versionId*string
curl -X GET "https://example.com/api/v1/tracks/string/versions/string/detail"

List todos for a specific version

GET
/api/v1/tracks/{id}/versions/{versionId}/todos

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
versionId*string
curl -X GET "https://example.com/api/v1/tracks/string/versions/string/todos"

Create a todo for a version

POST
/api/v1/tracks/{id}/versions/{versionId}/todos

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
versionId*string

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

curl -X POST "https://example.com/api/v1/tracks/string/versions/string/todos" \  -H "Content-Type: application/json" \  -d '{    "todo": "string"  }'

Update a todo

PATCH
/api/v1/tracks/{id}/versions/{versionId}/todos/{todoId}

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
versionId*string
todoId*string

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

curl -X PATCH "https://example.com/api/v1/tracks/string/versions/string/todos/string" \  -H "Content-Type: application/json" \  -d '{}'

Delete a todo

DELETE
/api/v1/tracks/{id}/versions/{versionId}/todos/{todoId}

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
versionId*string
todoId*string
curl -X DELETE "https://example.com/api/v1/tracks/string/versions/string/todos/string"

Update version description or lyrics

PATCH
/api/v1/tracks/{id}/versions/{versionId}/metadata

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
versionId*string

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

curl -X PATCH "https://example.com/api/v1/tracks/string/versions/string/metadata" \  -H "Content-Type: application/json" \  -d '{}'

Get play analytics for a version

GET
/api/v1/tracks/{id}/versions/{versionId}/plays

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
versionId*string
curl -X GET "https://example.com/api/v1/tracks/string/versions/string/plays"

Get presigned upload URL for a comment attachment (voice memo or file)

POST
/api/v1/tracks/{id}/versions/{versionId}/comments/upload

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
versionId*string
curl -X POST "https://example.com/api/v1/tracks/string/versions/string/comments/upload"

Create a comment with optional voice memo or file attachments

POST
/api/v1/tracks/{id}/versions/{versionId}/comments/with-attachments

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
versionId*string

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

curl -X POST "https://example.com/api/v1/tracks/string/versions/string/comments/with-attachments" \  -H "Content-Type: application/json" \  -d '{}'

Get Api V1 Tracks By Id Versions By Version Id Comments

GET
/api/v1/tracks/{id}/versions/{versionId}/comments

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
versionId*string
curl -X GET "https://example.com/api/v1/tracks/string/versions/string/comments"

Post Api V1 Tracks By Id Versions By Version Id Comments

POST
/api/v1/tracks/{id}/versions/{versionId}/comments

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
versionId*string

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

curl -X POST "https://example.com/api/v1/tracks/string/versions/string/comments" \  -H "Content-Type: application/json" \  -d '{    "comment": "string"  }'

Patch Api V1 Tracks By Id Versions By Version Id Comments By Comment Id

PATCH
/api/v1/tracks/{id}/versions/{versionId}/comments/{commentId}

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
versionId*string
commentId*string

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

curl -X PATCH "https://example.com/api/v1/tracks/string/versions/string/comments/string" \  -H "Content-Type: application/json" \  -d '{}'

Delete Api V1 Tracks By Id Versions By Version Id Comments By Comment Id

DELETE
/api/v1/tracks/{id}/versions/{versionId}/comments/{commentId}

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
versionId*string
commentId*string
curl -X DELETE "https://example.com/api/v1/tracks/string/versions/string/comments/string"

Post Api V1 Tracks By Id Versions By Version Id Comments By Comment Id Reactions

POST
/api/v1/tracks/{id}/versions/{versionId}/comments/{commentId}/reactions

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
versionId*string
commentId*string

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

curl -X POST "https://example.com/api/v1/tracks/string/versions/string/comments/string/reactions" \  -H "Content-Type: application/json" \  -d '{    "emoji": "string"  }'

Delete Api V1 Tracks By Id Versions By Version Id Comments By Comment Id Reactions By Emoji

DELETE
/api/v1/tracks/{id}/versions/{versionId}/comments/{commentId}/reactions/{emoji}

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
versionId*string
commentId*string
emoji*string
curl -X DELETE "https://example.com/api/v1/tracks/string/versions/string/comments/string/reactions/string"

Get Api V1 Tracks By Id Versions

GET
/api/v1/tracks/{id}/versions

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
curl -X GET "https://example.com/api/v1/tracks/string/versions"

Delete Api V1 Tracks By Id Versions By Version Id

DELETE
/api/v1/tracks/{id}/versions/{versionId}

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
versionId*string
curl -X DELETE "https://example.com/api/v1/tracks/string/versions/string"

Patch Api V1 Tracks By Id Versions By Version Id Final

PATCH
/api/v1/tracks/{id}/versions/{versionId}/final

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string
versionId*string
curl -X PATCH "https://example.com/api/v1/tracks/string/versions/string/final"

Patch Api V1 Tracks By Id Versions Reorder

PATCH
/api/v1/tracks/{id}/versions/reorder

Authorization

AuthorizationBearer <token>

Supabase access token — used by the web and mobile apps

In: header

Path Parameters

id*string

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

curl -X PATCH "https://example.com/api/v1/tracks/string/versions/reorder" \  -H "Content-Type: application/json" \  -d '{    "versions": [      {        "versionId": 0,        "order": 0      }    ]  }'
Was this helpful?

Auth

Authentication and session management (web & mobile only)

Albums

Album management — read endpoints available via API key