Skip to main content
POST
/
v1
/
platform
/
gateway-policies
/
search
Error
A valid request URL is required to generate request examples
[
  {
    "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>"
  }
]
{
  "error": "<string>"
}
{
  "error": "<string>"
}
{
  "error": "<string>"
}
{
  "error": "<string>"
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
policy_type
string
​
subject_matcher_key
string
​
subject_matcher_values
string[]

Response

OK

​
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