v48

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-275867561.6 MB

gateway-policies

Get a gateway policy

Returns a single gateway policy by id. Cross-org access is rejected with 404

Spend tracking: spend-cap policies include current_spend_usd for the active window so callers can read per-policy cost without hitting a separate endpoint. Guard policies leave it null.

get/v1/platform/gateway-policies/{id}

Path parameters

idstring uuid required

Policy ID

Response

actionstring

configobject

created_atstring

created_bystring

current_spend_usdnumber

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.

descriptionstring

enabledboolean

idstring

is_system_generatedboolean

namestring

organization_idstring

parent_policy_idstring

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_typestring

priorityinteger

updated_atstring