Upload Sessions

Create upload session

Creates an upload session for batch uploading tracks. By default returns an upload_session_id only — create tracks via POST /v1/upload/{upload_session_id}/track. Optionally include a nested track object to also create that track and receive track_id, the full track object (including delivery base_path/base_url), track_upload, and track_cover_upload on the session response (you can still add more tracks later).

post/v1/upload_session

Request

  • Base URL: https://api.audiodelivery.net
  • URL: https://api.audiodelivery.net/v1/upload_session
  • Auth: HTTP bearer

Request body

collection_idstring uuid required

Required unless the API key is scoped to a collection.

creator_idstring uuid
organization_indexstring
metadataobject
expires_ininteger

Session duration in seconds (default 3600, min 60, max 86400).

Response

Upload session created. When track was supplied in the request, also includes track_id, track, track_upload, and track_cover_upload.

oktrue required
api_request_idstring uuid required
upload_session_idstring uuid
player_colorstring nullable
player_color_lightstring nullable
player_color_darkstring nullable
expires_atstring date-time
track_idstring uuid

Present only when the request included a nested track object.

Changes

No recorded changes to this operation across all 1 revision of this API.