Troubleshooting & Error Reference

Troubleshooting & Resources

Common Issues & Resolutions

1. 401 Unauthorized

• Cause: Missing, invalid, or expired API key or JWT token.
• Fix: Verify Authorization: Bearer aw_... header syntax and check API key expiration at app.agentwiki.cc/settings/api-keys.

2. 403 Forbidden (Sandbox Access)

• Cause: Attempting to call production write, billing, or secrets endpoints using an ephemeral sandbox token.
• Fix: Authenticate with a production API key (aw_...).

3. Upload Failed (413 / File Too Large)

• Cause: Uploading a file exceeding the 100MB ceiling.
• Fix: Compress or split large archives before upload.

---

Standard Error Code Index

Status Code	Description	Typical Cause
400 Bad Request	Invalid payload or parameter	Request body failed Zod schema validation
401 Unauthorized	Missing / invalid credentials	Expired JWT or unrecognized API key
403 Forbidden	Insufficient permissions	Role or API key lacks required scope
404 Not Found	Resource does not exist	Invalid document ID or slug
429 Too Many Requests	Rate limit exceeded	Surpassed requests per minute quota
500 Internal Server Error	Worker runtime error	Unhandled edge exception

---

Platform Changelog

• v1.0.0: Initial launch of AgentWiki enterprise platform, dual-layer knowledge graph, native secrets manager, static site hosting, and OpenAPI 3.1 reference.