API reference/Audio

Build finished spots

Mix approved masters with existing sponsor tags for up to eight owned stations. Requires Idempotency-Key. Returns built count, partial failure and variation fallbacks; a partial result is not complete success.

POST/api/v1/audio/{slug}/finished

Authentication

Send your workspace key as xi-api-key or Authorization: Bearer.

audio:renderspend

Request headers

Idempotency-Key is required. Use 8 to 128 letters, digits, dots, colons, underscores or hyphens, and reuse the value only when retrying identical arguments. MCP callers supply idempotencyKey.

Parameters

Named placeholders belong in the path. Other arguments use a JSON body.

slugRequired: string
stationIdsRequired: array
lengthsRequired: array

Response

JSON response with status 200.

Requests and errors →

Illustrative arguments

{
  "slug": "YOUR_VALUE",
  "stationIds": [
    0
  ],
  "lengths": [
    15
  ]
}

Input schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-z0-9][a-z0-9-]*$"
    },
    "stationIds": {
      "minItems": 1,
      "maxItems": 8,
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 2147483647
      }
    },
    "lengths": {
      "minItems": 1,
      "maxItems": 4,
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "number",
            "const": 15
          },
          {
            "type": "number",
            "const": 30
          },
          {
            "type": "number",
            "const": 45
          },
          {
            "type": "number",
            "const": 60
          }
        ]
      }
    }
  },
  "required": [
    "slug",
    "stationIds",
    "lengths"
  ],
  "additionalProperties": false
}

Response schema

{
  "type": "object",
  "properties": {
    "built": {
      "type": "number"
    },
    "failure": {
      "type": "string"
    },
    "fellBack": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "built",
    "failure",
    "fellBack"
  ],
  "additionalProperties": false
}