Preview Effective Policy

Compute effective policy from rules without persisting a snapshot.

Useful for UIs that need to show the merged workspace/agent/task ceiling before the user commits a task creation.

post/v1/governance/effective-policy/preview

Request body

agent_idstring uuid nullable

Response

Successful Response

Changes

Changed in 4 of the 20 revisions of this API.428

Jul 30, 2026ce40e8663ec3325See the full diff
- ▲
  removed subschema #1 subschema #2 from the task_policy/anyOf[subschema #1: PolicyDocument]/budget/anyOf[subschema #1: BudgetPolicy]/monthly_spend_cap_usd request property anyOf list
  request-property-any-of-removed
- ▲
  removed subschema #1 subschema #2 from the task_policy/anyOf[subschema #1: PolicyDocument]/budget/anyOf[subschema #1: BudgetPolicy]/run_budget_usd request property anyOf list
  request-property-any-of-removed
- ▲
  removed subschema #1 subschema #2 from the task_policy/anyOf[subschema #1: PolicyDocument]/budget/anyOf[subschema #1: BudgetPolicy]/service_budget_usd request property anyOf list
  request-property-any-of-removed
- ●
  the task_policy/anyOf[subschema #1: PolicyDocument]/tokens/anyOf[subschema #1: TokenPolicy]/max_tokens/anyOf[subschema #1]/ request property's exclusiveMinimum was set to 0.00
  request-property-exclusive-min-set
- ●
  the task_policy/anyOf[subschema #1: PolicyDocument]/tokens/anyOf[subschema #1: TokenPolicy]/max_tokens_per_call/anyOf[subschema #1]/ request property's exclusiveMinimum was set to 0.00
  request-property-exclusive-min-set
- ○
  added the new optional request property task_policy/anyOf[subschema #1: PolicyDocument]/execution
  new-optional-request-property
- ○
  added subschema #1 to the task_policy/anyOf[subschema #1: PolicyDocument]/budget/anyOf[subschema #1: BudgetPolicy]/monthly_spend_cap_usd request property anyOf list
  request-property-any-of-added
- ○
  added subschema #1 to the task_policy/anyOf[subschema #1: PolicyDocument]/budget/anyOf[subschema #1: BudgetPolicy]/run_budget_usd request property anyOf list
  request-property-any-of-added
- ○
  added subschema #1 to the task_policy/anyOf[subschema #1: PolicyDocument]/budget/anyOf[subschema #1: BudgetPolicy]/service_budget_usd request property anyOf list
  request-property-any-of-added
- ○
  added the optional property effective_policy/execution to the response with the 200 status
  response-optional-property-added
Jul 25, 20269c1eb8f7f2d92See the full diff
- ○
  added the new optional request property task_policy/anyOf[subschema #1: PolicyDocument]/approval/anyOf[subschema #1: ApprovalPolicy]/approvers_by_tool
  new-optional-request-property
- ○
  added the optional property effective_policy/approval/anyOf[subschema #1: ApprovalPolicy]/approvers_by_tool to the response with the 200 status
  response-optional-property-added
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 18, 2026dad98bb652601See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 30, 2026e9c1532211601See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 133 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history