---
title: "Update agent credit limit"
method: PATCH
path: "/v1/agents/{agent_id}/credit_limit"
tags: ["Agents"]
---

# Update agent credit limit

`PATCH /v1/agents/{agent_id}/credit_limit`

## Path parameters

- `agent_id` union, required — The ID of the custom agent (a UUID). The personal agent (Notion AI) is not supported by this endpoint.
  - string
  - 'notion_ai' | '33333333-3333-3333-3333-333333333333' — One of: `notion_ai`, `33333333-3333-3333-3333-333333333333`

## Headers

- `Notion-Version` '2026-03-11', required

## Request body

- object
  - `credit_limit` number, nullable, required — The per-agent credit limit as a non-negative integer, or null to clear the limit.

## Response `200`

- object
  - `agent_id` string, uuid, required
  - `credit_limit` integer, nullable, required — The agent's editor-set per-agent credit limit; null when no limit applies.
  - `last_edited_time` string, required — ISO 8601 timestamp of when the agent was last edited.

## Other responses

- `400`
- `401`
- `403`
- `404`
- `406`
- `409`
- `429`
- `500`
- `503`
- `504`
- `529`

---

[API](https://skmtc.net/notion/apis/notion-api.md) · [All operations](https://skmtc.net/notion/apis/notion-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notion/notion-api/revisions/dee5763763b0/schema)