Troubleshooting

Blocked by policy errors

Understanding 403 policy_violation responses from export, run, refine, and publish.

4 min read

When an action violates effective policy, APIs return 403 with payloads such as:

  • policy_violation
  • policyKey (e.g. disableJsonExport, disablePlaygroundForRoles)
  • Human-readable message

The UI component BlockedByPolicy surfaces these errors. Ask your admin which workspace role you have and whether org or workspace policy blocks the action.

Note: Some generation endpoints may not attach workspace context the same way as playground—if behavior differs, your admin should review policy matrix in engineering notes.

Related articles