Create a submission request

Authorization

Send a personal access token with every request.

• Authorization: Bearer PAT

Path parameters

• batchIdstringrequired

Header parameters

• Idempotency-Keystring

  Optional idempotency key, at most 255 characters (UUIDv4 recommended). A repeated key returns the first response byte-for-byte, including a 5xx. The same key with a different body, or a second in-flight request, returns 409 IDEMPOTENCY_CONFLICT. Keys are unique per tenant and retained for 24 hours.

Request body

• recordingNamesobject

  Recording names chosen before upload, keyed by plan dataset key. Shape is checked by the service with VALIDATION_ERROR.

• datasetIdstring (uuid) | null

Responses

{
  "data": {
    "batchId": "string",
    "status": "string",
    "datasets": [
      {
        "datasetId": "string",
        "datasetVersionId": "string",
        "name": "string",
        "slug": "string",
        "fileCount": 0,
        "totalBytes": 0
      }
    ]
  }
}