Update credit limit for an agent in a space

curl --request PUT \
  --url https://api.notion.com/admin/v1/spaces/{space_id}/agents/{agent_id}/credit_limit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Notion-Version: <notion-version>' \
  --data '
{
  "credit_limit": 123
}
'

import requests

url = "https://api.notion.com/admin/v1/spaces/{space_id}/agents/{agent_id}/credit_limit"

payload = { "credit_limit": 123 }
headers = {
    "Notion-Version": "<notion-version>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {
    'Notion-Version': '<notion-version>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({credit_limit: 123})
};

fetch('https://api.notion.com/admin/v1/spaces/{space_id}/agents/{agent_id}/credit_limit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.notion.com/admin/v1/spaces/{space_id}/agents/{agent_id}/credit_limit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'credit_limit' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Notion-Version: <notion-version>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.notion.com/admin/v1/spaces/{space_id}/agents/{agent_id}/credit_limit"

	payload := strings.NewReader("{\n  \"credit_limit\": 123\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Notion-Version", "<notion-version>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.notion.com/admin/v1/spaces/{space_id}/agents/{agent_id}/credit_limit")
  .header("Notion-Version", "<notion-version>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"credit_limit\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.notion.com/admin/v1/spaces/{space_id}/agents/{agent_id}/credit_limit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Notion-Version"] = '<notion-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"credit_limit\": 123\n}"

response = http.request(request)
puts response.read_body

{
  "credit_limit_by_workspace_admin": 123,
  "enforced_credit_limit": 123,
  "current_credit_usage": 123,
  "did_clear_paused_state": true,
  "is_active": true
}

{
  "type": "error",
  "code": "validation_error",
  "status": 400,
  "message": "The request body is invalid."
}

{
  "type": "error",
  "code": "unauthorized",
  "status": 401,
  "message": "Unauthorized."
}

{
  "type": "error",
  "code": "forbidden",
  "status": 403,
  "message": "Forbidden."
}

{
  "type": "error",
  "code": "not_found",
  "status": 404,
  "message": "Not found."
}

{
  "type": "error",
  "code": "rate_limited",
  "status": 429,
  "message": "Rate limited."
}

{
  "type": "error",
  "code": "internal_server_error",
  "status": 500,
  "message": "An unexpected error occurred."
}

PUT

spaces

{space_id}

agents

{agent_id}

credit_limit

Update credit limit for an agent in a space

curl --request PUT \
  --url https://api.notion.com/admin/v1/spaces/{space_id}/agents/{agent_id}/credit_limit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Notion-Version: <notion-version>' \
  --data '
{
  "credit_limit": 123
}
'

import requests

url = "https://api.notion.com/admin/v1/spaces/{space_id}/agents/{agent_id}/credit_limit"

payload = { "credit_limit": 123 }
headers = {
    "Notion-Version": "<notion-version>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {
    'Notion-Version': '<notion-version>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({credit_limit: 123})
};

fetch('https://api.notion.com/admin/v1/spaces/{space_id}/agents/{agent_id}/credit_limit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.notion.com/admin/v1/spaces/{space_id}/agents/{agent_id}/credit_limit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'credit_limit' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Notion-Version: <notion-version>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.notion.com/admin/v1/spaces/{space_id}/agents/{agent_id}/credit_limit"

	payload := strings.NewReader("{\n  \"credit_limit\": 123\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Notion-Version", "<notion-version>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.notion.com/admin/v1/spaces/{space_id}/agents/{agent_id}/credit_limit")
  .header("Notion-Version", "<notion-version>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"credit_limit\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.notion.com/admin/v1/spaces/{space_id}/agents/{agent_id}/credit_limit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Notion-Version"] = '<notion-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"credit_limit\": 123\n}"

response = http.request(request)
puts response.read_body

{
  "credit_limit_by_workspace_admin": 123,
  "enforced_credit_limit": 123,
  "current_credit_usage": 123,
  "did_clear_paused_state": true,
  "is_active": true
}

{
  "type": "error",
  "code": "validation_error",
  "status": 400,
  "message": "The request body is invalid."
}

{
  "type": "error",
  "code": "unauthorized",
  "status": 401,
  "message": "Unauthorized."
}

{
  "type": "error",
  "code": "forbidden",
  "status": 403,
  "message": "Forbidden."
}

{
  "type": "error",
  "code": "not_found",
  "status": 404,
  "message": "Not found."
}

{
  "type": "error",
  "code": "rate_limited",
  "status": 429,
  "message": "Rate limited."
}

{
  "type": "error",
  "code": "internal_server_error",
  "status": 500,
  "message": "An unexpected error occurred."
}

The organization bot token must have the following scopes:

workflows:write

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version

enum<string>

required

The Admin API version to use for this request.

Available options:

2026-06-01

Path Parameters

agent_id

string<uuid>

required

The ID of the custom agent (a UUID). The personal agent (Notion AI) is not supported.

space_id

string<uuid>

required

Body

application/json

credit_limit

number | null

required

The per-agent credit limit as a non-negative integer, or null to clear the limit.

Response

credit_limit_by_workspace_admin

number | null

required

The workspace admin credit limit after the change, or null if no workspace admin limit applies.

enforced_credit_limit

number | null

required

The credit limit that applies to the agent after the change. This is the lower of the workspace admin limit and the limit set by the agent creator. The workspace default applies if neither limit is set. null means no limit applies.

current_credit_usage

number | null

required

The agent's credit usage in the current billing period, or null if the billing period is unknown.

did_clear_paused_state

boolean

required

Whether this change resumed the agent after a credit-limit or runaway-credit-usage pause.

is_active

boolean

required

Whether the agent is active after the change. false can mean this change paused the agent or that the agent was already paused for another reason.

⌘I