---
title: "Set the pinned-token cap"
method: PUT
path: "/pins/cap"
tags: ["Pinned documents"]
---

# Set the pinned-token cap

`PUT /pins/cap`

## Request

- Base URL: `https://app.jitprompt.com`
- URL: `https://app.jitprompt.com/pins/cap`
- Auth: HTTP bearer

The most estimated tokens the pinned block may take, up to the
server's maximum; `null` for the default. 422 below what is pinned now.

## Request body

- PinCap
  - `cap` integer, nullable

## Response `200`

Successful Response

- Pins
  - `pins` PinnedDocument[], required
    - `id` string, required
    - `title` string, required
    - `source_name` string, required
    - `status` string, required
    - `est_tokens` integer, required
    - `included` boolean, required
  - `total_tokens` integer, required
  - `cap` integer, required
  - `max` integer, required

## Other responses

- `422`: Validation Error

---

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