MOmoda
media

Cancel Audio Generation

Changed on

Cancel a managed-voice generation. Idempotent; always 200 with the task envelope.

Before the provider is called the task ends canceled and nothing is charged. Once the request is on its way to the provider it cannot be stopped: the envelope says cancel_requested: true with the current status, and the task still ends succeeded (charged, audio delivered) or failed. A cancel is never a refund, and a terminal task is returned unchanged.

post/media/generate-audio/{task_id}/cancel

Request

  • Base URL
    https://api.moda.app/v1
  • URL
    https://api.moda.app/v1/media/generate-audio/{task_id}/cancel
  • Auth
    HTTP bearer

Path parameters

task_idstring required

Headers

Moda-Version'2026-04-12' | '2026-05-01'
Example:2026-05-01

Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.

Request body

CancelAudioGenerationRequest required

POST /v1/media/generate-audio/{task_id}/cancel takes an empty body or {}.

Response

Successful Response

object required

Changes