policy_id: null 会清除绑定,该密钥随即恢复为不受任何护栏约束的状态——不会自动回退到组织或用户的默认策略。
身份验证
需要携带具有billing API 密钥权限范围的 Bearer 令牌,并具备对该密钥的访问权限(调用方必须是该密钥的所有者,或者——对于团队密钥——通过所属组织获得访问权限)。
GET
读取当前绑定。PUT
设置或清除绑定。string
策略 UUID。传入
null 可完全清除该绑定。范围规则
- 个人策略只能绑定到其作者本人拥有的密钥。
- 团队策略只能绑定到同一组织内的密钥。
- 跨越该边界会返回
400 guardrail_policy_not_bindable,并附带厂商中立的错误消息。
错误
400 guardrail_policy_not_bindable—— 该策略在此密钥的范围内不可见。404 not_found—— 密钥或策略不存在(或对调用方不可见)。
