---
title: "Get Creation Allowance"
method: GET
path: "/api/v1/custom_pipelines/creation-allowance"
tags: ["Custom Pipelines (Deprecated)"]
---

# Get Creation Allowance

`GET /api/v1/custom_pipelines/creation-allowance`

2026 custom-processor CREATION allowance preview for the current team (§5).

The frontend reads this BEFORE creating a NEW processor to show the at-cap block
(Free / developer hard cap) or the one-time $5 confirmation (Team).

NOTE: the path is registered BEFORE /custom_pipelines/{lookup_key} so the literal
"creation-allowance" segment is matched by this route, not captured as a lookup_key.

## Cookies

- `wos-session` string
- `datalab_active_team` string

## Response `200`

Successful Response

- CustomProcessorCreationAllowanceResponse — 2026 custom-processor CREATION allowance preview for the current team (§5). The frontend uses this BEFORE creating a NEW processor to show the at-cap block (Free / developer hard cap) or the one-time $5 confirmation (Team).
  - `creations_this_cycle` integer, required — Successful NEW-processor creations counted this billing month
  - `limit` integer, required — Included creations per month for the team's plan (or per-team override)
  - `at_cap` boolean, required — True when a hard-cap plan has used all its included creations (next creation is blocked with 402)
  - `will_incur_fee` boolean, required — True when the next creation would incur the one-time overage fee (Team)
  - `fee_cents` integer, required — The one-time fee in cents the next creation would incur (0 when within the allowance or hard-capped)
  - `overage_unit_fee_cents` integer — The plan's per-extra-creation fee in cents regardless of current count (0 for hard-cap plans) — lets the UI state the overage policy up front
  - `plan` string, nullable — The plan whose limits apply (the team's active API plan, else 'free')
  - `cycle_resets_at` string, required — ISO timestamp when the monthly creation count resets

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/datalab/apis/datalab-api.md) · [All operations](https://skmtc.dev/datalab/apis/datalab-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/datalab/datalab-api/revisions/aa9f8ee18efb/schema)