Skip to main content

Create Dataset

Create a named dataset to organize your candidate tracks.
  • /trace/v1/dataset

Request Body

Request Body Example

Response

Status 201 Created

List Datasets

List all datasets owned by the authenticated API key user.
  • /trace/v1/dataset

Response

Status 200 OK

Get Dataset Details

Retrieve details for a specific dataset using its unique ID.
  • /trace/v1/dataset/{dataset_id}

Response

Status 200 OK

Limits & Validation Errors

To prevent processing failures, datasets enforce the following system limits:
  • File Sizes: Max 100 MB per file.
  • Track Duration: Max 300 seconds (5 minutes) per track.
  • File Formats: .mp3, .wav, .flac, .m4a files only.
  • Max Number of Files: Max 10 blobs per /trace/v1/ingest/type* request.
  • Max Search Matrix (M×N): Max 100,000 comparison pairs per search job.

Common Error Scenarios

  • 400 Bad Request: Returned if a batch exceeds 10 files, the audio duration is longer than 5 minutes, or the file format is unsupported.
  • 413 Payload Too Large: Returned during upload if a file exceeds 100 MB.
  • 404 Not Found: Returned if the requested dataset_name does not exist in the database.