Troubleshooting

Common Issues

Symptom	Likely Cause	Action
User can sign in but sees no data	Missing tenant, role, or subscription access	Confirm tenant assignment and subscription state
API returns unauthorized	Missing, expired, or invalid credential	Refresh token or rotate API key
API response parsing fails	Client expected JSON content type only	Parse body as JSON even when content type is text/plain
Extraction returns empty fields	Template does not match document	Review template definitions and sample documents
Classification is wrong	Document type is ambiguous	Route to review and improve classifier examples
Billing feature is unavailable	Subscription or entitlement issue	Check billing status and product plan

Investigation Flow

1. Identify whether the issue is user, tenant, API, document, provider, billing, or deployment related.
2. Confirm the environment and timestamp.
3. Reproduce with known-good credentials or sample data.
4. Check application logs and Cloud Run revision status.
5. Record support-safe identifiers.
6. Escalate with the support data checklist from observability docs.

Related Docs

• Observability
• API Errors
• FAQ