Error Codes

Error Code
Description
Resolution

401

Unauthorized - Invalid API token

Verify GITBOOK_API_TOKEN is correct

403

Forbidden - Insufficient permissions

Check space/organization access permissions

404

Not Found - Resource doesn't exist

Verify space/page/collection IDs are correct

429

Rate Limited - Too many requests

Implement request throttling

500

Internal Server Error

Check server logs for detailed error information

Common Issues

  • Token Issues: Ensure token starts with gb_live_, is not expired, and has correct permissions.

  • ID Resolution: Use list_organizations and list_spaces to find valid IDs.

  • Configuration Issues: Verify environment variables and CLI arguments.