---
title: "Approve future runs of an exact request within set spending limits"
method: POST
path: "/v1/capacity/schedules"
---

# Approve future runs of an exact request within set spending limits

`POST /v1/capacity/schedules`

## Request

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

## Request body

- CapacityScheduleRequest
  - `idempotency_key` string, required
  - `scope` CapacityQuoteRequest, required
    - `ast_hash` string, required
    - `operation` 'find' | 'extend' | 'add_facts' | 'refresh' | 'retained'
    - `parent_find_id` string, nullable
    - `revision_id` string, nullable
    - `project_id` string, nullable
    - `source_import_id` string, nullable
    - `source_row_ids` string[]
    - `requested_units` integer
    - `minimum_units` integer, nullable
    - `selected_entity_ids` string[], nullable
  - `cadence_seconds` integer, required
  - `first_due_at` string, date-time, required
  - `per_run_cents` integer, required
  - `period_cents` integer, required
  - `calendar_schedule` CalendarSchedule
    - `startAt` string, date, required
    - `hour` integer, required
    - `minute` integer
    - `timezone` string, required
    - `type` 'hours' | 'days' | 'weeks' | 'months' | 'years', required
    - `interval` integer, required
    - `daysOfWeek` integer[]
  - `valid_until` string, date-time, required

## Response `201`

Approve future runs of an exact request within set spending limits

- object
  - `data` object, required

## 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)