---
title: "Set the organization’s own per-question credit caps"
method: PUT
path: "/api/orgs/{orgId}/credit-caps"
tags: ["credits"]
---

# Set the organization’s own per-question credit caps

`PUT /api/orgs/{orgId}/credit-caps`

## Request

- Base URL: `https://api.wizbi.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wizbi.ai/api/orgs/{orgId}/credit-caps`
- Auth: none declared

`{soft, hard}` (soft warns the person, hard stops the question) or null for the defaults. The value is stored as the org’s; the caps in force are bounded by the ceiling the platform set (`effective`). Needs the `budgets` component. Audited `credits.caps.put`.

## Path parameters

- `orgId` string, required

## Request body

- CreditCapsPutBody
  - `caps` object, nullable, required
    - `soft` integer, required
    - `hard` integer, required

## Response `200`

OK.

- CreditCapsPutResult
  - `caps` CreditCapsView, required
    - `org` object, nullable, required
      - `soft` integer, required
      - `hard` integer, required
    - `ceiling` object, nullable, required
      - `soft` number
      - `hard` number
    - `effective` object, required
      - `soft` integer, required
      - `hard` integer, required
    - `applied` boolean, required
    - `source` 'default' | 'org' | 'ceiling', required

## Other responses

- `401`: No resolved context.
- `403`: Not an org admin (`forbidden`), or the component is off (`feature_disabled`).

---

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