---
title: "Mutate render queue (enqueue/claim/progress/complete/fail)"
method: POST
path: "/api/video/render-queue"
tags: ["video", "platform"]
---

# Mutate render queue (enqueue/claim/progress/complete/fail)

`POST /api/video/render-queue`

## Request body

- object
  - `action` 'enqueue' | 'claim_next' | 'progress' | 'complete' | 'fail', required
  - `projectId` string
  - `outputPresetId` string
  - `planTier` 'free' | 'pro' | 'team'
  - `durationSeconds` number
  - `workerId` string
  - `jobId` string
  - `progressPercent` number
  - `stage` string
  - `outputUrl` string
  - `error` string
  - `cancelled` boolean

## Response `200`

Queue mutation payload

## Other responses

- `201` — Render job enqueued
- `204` — No queued job available
- `400` — Validation error

---

[API](https://skmtc.net/memesio/apis/memesio-api-contracts.md) · [All operations](https://skmtc.net/memesio/apis/memesio-api-contracts/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/memesio/memesio-api-contracts/revisions/826e6edbf294/schema)