API Reference
Error Handling
Map API errors to retries, user actions, and billing guidance.
Overview
Error responses are stable and machine-readable. Drive behavior using status code plus structured detail payloads.
What You Will Learn
- When to retry automatically vs require user action.
- Billing, quota, and plan-limit failure patterns.
- Validation errors for payload limits and field constraints.
Implementation Checklist
- Handle 400 validation errors with field-level feedback.
- Handle 401/403 auth and permission errors with account remediation.
- Handle 402 billing and quota errors by linking billing actions.
- Retry only transient 5xx errors with capped exponential backoff.
Relevant Endpoints
POST
/v1/pinsValidation, billing, and upstream publish errors.
POST
/v1/schedulesSchedule validation and state errors.
GET
/v1/billing/statusExplain billing and quota state in-product.