---
title: "Enqueue Job"
method: POST
path: "/v1/jobs"
---

# Enqueue Job

`POST /v1/jobs`

## Request

- Base URL: `https://api.storyflo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.storyflo.com/v1/jobs`
- Auth: none declared

Queue a render. Returns immediately with the job id; the worker
picks it up within ``IDLE_POLL_SECONDS``. Use ``GET /v1/jobs/{id}``
to poll for completion.

## Query parameters

- `api_key` string, nullable

## Headers

- `x-storyflo-key` string, nullable
- `x-readout-key` string, nullable

## Request body

- JobEnqueueRequest
  - `voice` string, required
  - `text` string, required
  - `speed` number
  - `publisher_id` string, nullable
  - `article_id` string, nullable

## Response `202`

Successful Response

- JobView
  - `id` string, required
  - `status` string, required
  - `voice_id` string, required
  - `attempts` integer, required
  - `audio_keys` string[], nullable
  - `error` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/storyflo/apis/storyflo-inference-router.md) · [All operations](https://skmtc.dev/storyflo/apis/storyflo-inference-router/llms.txt) · [OpenAPI document](https://skmtc.dev/storyflo/apis/storyflo-inference-router/revisions/c3a1a735ac7a?raw)