Skip to content

docs: complete the error catalog from the code - #120

Merged
pavancharak merged 1 commit into
mainfrom
docs/audit-error-catalog
Oct 2, 2026
Merged

pavancharak merged 1 commit into
mainfrom
docs/audit-error-catalog

Conversation

@pavancharak

Copy link
Copy Markdown
Owner

What

Page by page audit, batch 3: the error catalog. It covered the execution routes only; every error code the server raises was checked against it (source, the integration tests that assert each code, and earlier captures).

  • New section, policy in effect: 400 missing capability, 403 CAPABILITY_NOT_ALLOWED, 404 CAPABILITY_NOT_BOUND, 409 NO_APPROVED_POLICY_VERSION, 503 POLICY_VERSION_UNAVAILABLE.
  • New section, governance (policy changes, approvers, external connectors): NON_HUMAN_CALLER_DENIED on every route including reads, SAME_ACTOR_CANNOT_APPROVE_OWN_CHANGE, STEP_UP_AUTHORIZATION_INVALID, PENDING_POLICY_CHANGE_NOT_FOUND, EXTERNAL_CONNECTOR_CHANGE_NOT_FOUND, INVALID_EXTERNAL_CONNECTOR, EXTERNAL_ENDPOINT_ADDRESS_REFUSED, CONFLICT, and the uncoded field 400s.
  • 503 AUDIT_UNAVAILABLE row; the POLICY_DENIED row now names approval, bound signal and policy version refusals.
  • Correction to docs: audit the API guide pages against the code #119: NONCE_ALREADY_CONSUMED is not reachable over HTTP (a repeated id is refused with 409 first), as the catalog's own note said. Removed from the common codes on Error handling and reworded on Idempotency; CONFLICT added instead.
  • Prose dashes removed (the one inside a real server message is kept).

🤖 Generated with Claude Code

The catalog covered execution routes only. Checked every error code the
server raises against it on 2026-10-02.

- New sections: policy in effect (CAPABILITY_NOT_BOUND,
  NO_APPROVED_POLICY_VERSION, POLICY_VERSION_UNAVAILABLE) and governance
  (NON_HUMAN_CALLER_DENIED, SAME_ACTOR_CANNOT_APPROVE_OWN_CHANGE,
  STEP_UP_AUTHORIZATION_INVALID, PENDING_POLICY_CHANGE_NOT_FOUND,
  EXTERNAL_CONNECTOR_CHANGE_NOT_FOUND, INVALID_EXTERNAL_CONNECTOR,
  EXTERNAL_ENDPOINT_ADDRESS_REFUSED, CONFLICT).
- AUDIT_UNAVAILABLE row; POLICY_DENIED row names approval, bound signal
  and policy version refusals.
- Error handling and idempotency pages: NONCE_ALREADY_CONSUMED is not
  reachable over HTTP (a repeated id is a 409 first), as the catalog
  already said; CONFLICT added to the common codes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Oct 2, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
parmana-api-real Ready Ready Preview Oct 2, 2026 10:10am UTC
parmana-sandbox Ready Ready Preview Oct 2, 2026 10:10am UTC

@mintlify

mintlify Bot commented Oct 2, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
parmanasystems 🟢 Ready View Preview Oct 2, 2026, 10:09 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

This branch was successfully deployed

3 active deployments
Preview – parmana-api-real — f72658b1 Deployed Oct 2, 2026 by vercel[bot]
Preview – parmana-sandbox — f72658b1 Deployed Oct 2, 2026 by vercel[bot]
staging - docs/site — f72658b1 Deployed Oct 2, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant