Skip to main content
Deprecated. This endpoint is retained for backward compatibility, but new integrations should use Create Task instead. /create-task collapses the warmup → poll → assign-task sequence into a single call that returns the SRT URL synchronously.

​
Overview

Pre-start a worker instance for a specific sport type. Use the returned narrative_task_id with the Assign Task endpoint to assign work to the warmed-up instance, after polling Get Task Status until the worker is ready.

​
Request Parameters

​
Example Request

​
Example Response

​
Response Fields

​
Error Handling

​
Rate Limits

Each account has a concurrent task limit. If you have no limit configured, the API returns 403:
If you are at your limit, the API returns 429:
Kill a running task or wait for one to finish before creating a new one.

​
Worker Launch Failure

If the worker fails to start (e.g., due to high traffic), the API returns a 500 error:
Retry with a new warmup request after a short delay.

​
Workflow

  1. Call /tasks/warmup with the sport type
  2. Save the returned narrative_task_id
  3. When ready to process, call /tasks/assign-task with the task ID and stream details
  4. The warmed-up instance immediately begins processing

​
Use Cases

  • Pre-game warmup: Start instances before a scheduled broadcast
  • Capacity reservation: Ensure resources are available during peak times
  • Reduced latency: Eliminate cold-start delay when time is critical

​
Notes

  • Warmed instances consume resources while waiting for assignment
  • Assign work promptly to avoid unnecessary costs