/ Docs / Troubleshooting

Support

Troubleshooting

Common integration failures with fast diagnosis and recovery actions.

403 `agent_not_allowed_for_share`

Agent is not in share allow-list. Resolve with a permitted agent or recreate share policy including this agent.

401 `invalid_grant`

Grant is missing, malformed, or expired. Re-run resolve → grant and retry fetch with new X-Access-Grant.

409 `grant_already_used`

Grant tokens are one-use. Mint a fresh grant for each protected fetch retry.

404 `share_not_found_or_expired`

Share TTL elapsed or ID is invalid. Re-upload or generate a new share with appropriate TTL.