API reference/Audio

Render a sponsor tag

Spend a house-voice render to replace an owned station's sponsor tag. The tag must fit six seconds. Price is a positive whole-dollar amount; null clears it. Existing finished spots for that tag are invalidated. Requires Idempotency-Key and the existing workspace daily render allowance.

POST/api/v1/audio/{slug}/tags/{stationId}

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
stationIdRequired: integerRange: 0 to 2147483647
businessRequired: string
taglineRequired: string
sayItOptional: string
priceOptional: See schema for accepted values.

Response

JSON response with status 200.

Requests and errors →

Illustrative arguments

{
  "slug": "YOUR_VALUE",
  "stationId": 0,
  "business": "YOUR_VALUE",
  "tagline": "YOUR_VALUE",
  "sayIt": "",
  "price": null
}

Input schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-z0-9][a-z0-9-]*$"
    },
    "stationId": {
      "type": "integer",
      "minimum": 0,
      "maximum": 2147483647
    },
    "business": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "tagline": {
      "type": "string",
      "maxLength": 200
    },
    "sayIt": {
      "default": "",
      "type": "string",
      "maxLength": 300
    },
    "price": {
      "default": null,
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 10000000
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "slug",
    "stationId",
    "business",
    "tagline"
  ],
  "additionalProperties": false
}

Response schema

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "const": true
    }
  },
  "required": [
    "ok"
  ],
  "additionalProperties": false
}