Get a gateway policy

{ "action": "<string>", "config": {}, "created_at": "<string>", "created_by": "<string>", "current_spend": [ { "spend_usd": 123, "window": "<string>" } ], "current_spend_usd": 123, "current_usage": [ { "metric": "requests", "value": 123, "window": "minute" } ], "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>" }

Authorizations

X-API-Key

string

header

required

Path Parameters

string<uuid>

required

Policy ID

Response

action

string

config

object

created_at

string

created_by

string

current_spend

object[]

CurrentSpend is the list of spends recorded for each of the tracked spend limit windows, used in v2 of spend_cap policy type.

Show child attributes

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.

current_usage

object[]

CurrentUsage is the consumed units in each configured limit's current window. Set for any rate_limit policy regardless of enabled state, one entry per limit in the config. Nil for non-rate_limit policies or when the usage lookup failed.

Show child attributes

description

string

enabled

boolean

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. An explicit Update or a Create with the same matchers clears the link and takes ownership of the materialized row. Delete on the parent cascade-soft-deletes children still attached.

policy_type

string

priority

integer

subject_matchers

object[]

Show child attributes

updated_at

string

SmithDB SDK migration

LangSmith REST API

Authorizations

Path Parameters

Response