---
title: "Ask for a list in plain words and run it within a maximum price, answering at once"
method: POST
path: "/v1/capacity/requests"
---

# Ask for a list in plain words and run it within a maximum price, answering at once

`POST /v1/capacity/requests`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/capacity/requests`
- Auth: API key in header `Authorization`

## Request body

- CapacityStartRequest: A list asked in plain words, run only if its price is within confirm_max_cents.
  - `q` string, required
  - `requested_units` integer
  - `confirm_max_cents` integer, required
  - `maximum_price_usd` number, nullable
  - `idempotency_key` string, required
  - `locale` string
  - `callback_url` string, nullable

## Response `202`

Ask for a list in plain words and run it within a maximum price, answering at once

- object
  - `data` CapacityStartData, required
    - `idempotency_key` string, required
    - `state` 'reading' | 'started' | 'needs_edit' | 'above_maximum' | 'failed', required
    - `message` string, nullable
    - `read_back` string, nullable
    - `maximum_cents` integer, nullable
    - `find_id` string, nullable
    - `retry_after_seconds` integer, nullable

## Other responses

- `default`: Error envelope

---

[API](https://skmtc.dev/specstream/apis/specstream-api.md) · [All operations](https://skmtc.dev/specstream/apis/specstream-api/llms.txt) · [OpenAPI document](https://skmtc.dev/specstream/apis/specstream-api/revisions/5a9f51143a13?raw)