---
title: "Submit a batch of skybox generations."
method: POST
path: "/api/v1/skybox/batch"
tags: ["Skybox Batch Generation"]
---

# Submit a batch of skybox generations.

`POST /api/v1/skybox/batch`

## Request

- Base URL: `https://backend.blockadelabs.com`
- URL: `https://backend.blockadelabs.com/api/v1/skybox/batch`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/blockadelabs/apis/blockade-labs-api-documentation/docs/api/v1/skybox/batch/post.ts> (a function with typed inputs; its response is checked against the schema)

## Headers

- `x-api-key` string

## Request body

- object
  - `prompt` string, required: Prompt text for the generated skyboxes.
  - `skybox_style_id` integer: Skybox style ID. Defaults to the configured default style when omitted.
  - `quantity` integer, required: Number of skyboxes to generate. Must be a positive integer.
  - `variant_id` integer: Required for Model 4 styles. Selects the Standard or Enhanced variant.
  - `webhook_url` string: Optional webhook URL for batch status updates.

## Response `200`

- object
  - `id` integer
  - `obfuscated_id` string
  - `user_id` integer
  - `status` string
  - `quantity` integer
  - `successfully_submitted` integer
  - `completed` integer
  - `errored` integer
  - `pusher_channel` string
  - `pusher_event` string
  - `webhook_url` string
  - `submission_errors` unknown[]
    - unknown
  - `generations` object[]
    - `id` integer
    - `status` string

## Other responses

- `403`
- `422`

---

[API](https://skmtc.dev/blockadelabs/apis/blockade-labs-api-documentation.md) - [All operations](https://skmtc.dev/blockadelabs/apis/blockade-labs-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/blockadelabs/apis/blockade-labs-api-documentation/revisions/7560ac18c09c?raw)