Update agent spend cap

PUT/workspaces/{organizationId}/agent/spend-caps/{agentId}

Path parameters

organizationIdstringrequired

agentIdstringrequired

Request body

application/json

maxRunsPerDayinteger | null

min 1

maxRunsPerMonthinteger | null

min 1

maxTokensPerDayinteger | null

min 0

maxTokensPerMonthinteger | null

min 0

maxCostMicrosPerDayinteger | null

min 0

maxCostMicrosPerMonthinteger | null

min 0

maxTokensPerRuninteger | null

min 0

maxCostMicrosPerRuninteger | null

min 0

Responses

200

Spend caps upserted for the agent type — null fields clear a limit; omitted fields keep their value

idstringrequired

organizationIdstringrequired

agentIdstringrequired

maxRunsPerDayinteger | nullrequired

maxRunsPerMonthinteger | nullrequired

maxTokensPerDayinteger | nullrequired

maxTokensPerMonthinteger | nullrequired

maxCostMicrosPerDayinteger | nullrequired

maxCostMicrosPerMonthinteger | nullrequired

maxTokensPerRuninteger | nullrequired

maxCostMicrosPerRuninteger | nullrequired

lastCapAlertAtstring | nullrequired

createdBystring | nullrequired

createdAtstringrequired

updatedAtstringrequired

Try it

Server

Custom base URLOverrides the selected server when set.

Parameters

organizationIdpath*agentIdpath*

Bodyapplication/json

maxRunsPerDayintegermaxRunsPerMonthintegermaxTokensPerDayintegermaxTokensPerMonthintegermaxCostMicrosPerDayintegermaxCostMicrosPerMonthintegermaxTokensPerRunintegermaxCostMicrosPerRuninteger

Request

curl -X PUT '/workspaces/string/agent/spend-caps/string' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "maxRunsPerDay": 1,
  "maxRunsPerMonth": 1,
  "maxTokensPerDay": 0,
  "maxTokensPerMonth": 0,
  "maxCostMicrosPerDay": 0,
  "maxCostMicrosPerMonth": 0,
  "maxTokensPerRun": 0,
  "maxCostMicrosPerRun": 0
}'

const response = await fetch("/workspaces/string/agent/spend-caps/string", {
  method: "PUT",
  headers: {
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"maxRunsPerDay\": 1,\n  \"maxRunsPerMonth\": 1,\n  \"maxTokensPerDay\": 0,\n  \"maxTokensPerMonth\": 0,\n  \"maxCostMicrosPerDay\": 0,\n  \"maxCostMicrosPerMonth\": 0,\n  \"maxTokensPerRun\": 0,\n  \"maxCostMicrosPerRun\": 0\n}"
});

import requests

response = requests.put(
    "/workspaces/string/agent/spend-caps/string",
    headers={
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"maxRunsPerDay\": 1,\n  \"maxRunsPerMonth\": 1,\n  \"maxTokensPerDay\": 0,\n  \"maxTokensPerMonth\": 0,\n  \"maxCostMicrosPerDay\": 0,\n  \"maxCostMicrosPerMonth\": 0,\n  \"maxTokensPerRun\": 0,\n  \"maxCostMicrosPerRun\": 0\n}",
)

Response

{
  "id": "string",
  "organizationId": "string",
  "agentId": "string",
  "maxRunsPerDay": 0,
  "maxRunsPerMonth": 0,
  "maxTokensPerDay": 0,
  "maxTokensPerMonth": 0,
  "maxCostMicrosPerDay": 0,
  "maxCostMicrosPerMonth": 0,
  "maxTokensPerRun": 0,
  "maxCostMicrosPerRun": 0,
  "lastCapAlertAt": "string",
  "createdBy": "string",
  "createdAt": "string",
  "updatedAt": "string"
}