Skip to main content
POST
/
v1
/
platform
/
gateway-policies
{
  "name": "monthly-cap",
  "policy_type": "spend_cap",
  "action": "block",
  "subject_matchers": [{"key":"organization_id","value":"<org-uuid>"}],
  "config": {"window": "monthly", "limit_usd": 100}
}
{
  "action": "<string>",
  "config": {},
  "created_at": "<string>",
  "created_by": "<string>",
  "current_spend_usd": 123,
  "description": "<string>",
  "enabled": true,
  "id": "<string>",
  "is_system_generated": true,
  "name": "<string>",
  "organization_id": "<string>",
  "parent_policy_id": "<string>",
  "policy_type": "<string>",
  "priority": 123,
  "subject_matchers": [
    {
      "key": "<string>",
      "value": "<string>"
    }
  ],
  "updated_at": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.langchain.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
action
string
​
config
object
​
description
string
​
enabled
boolean
​
name
string
​
policy_type
string
​
priority
integer
​
subject_matchers
object[]

Response

Created

​
action
string
​
config
object
​
created_at
string
​
created_by
string
​
current_spend_usd
number

CurrentSpendUSD is the spend in the policy's current window. Set for any spend_cap policy regardless of enabled state — disabled policies still surface usage so users can see what would have been counted. Nil for non-spend_cap policies or when the spend lookup failed.

​
description
string
​
enabled
boolean
​
id
string
​
is_system_generated
boolean
​
name
string
​
organization_id
string
​
parent_policy_id
string

ParentPolicyID is set on materialized children of a default_spend_cap to the default's id, and cleared (NULL) only when an admin Create with the same matchers takes over the materialized row. Update on a child preserves the link; Delete on the parent cascade-soft-deletes every child rather than detaching them.

​
policy_type
string
​
priority
integer
​
subject_matchers
object[]
​
updated_at
string