Introduction

Base URL

https://public-api.spellweave.app/api/v1

Authentication

All API requests require a valid OAuth 2.0 access token passed in theAuthorization header. The API uses Authorization Code + PKCE for secure token exchange.

Authorization: Bearer YOUR_ACCESS_TOKEN

Response Format

All responses follow a consistent envelope format with data and meta fields.

{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-03-31T14:22:00Z"
  }
}

Pagination

List endpoints support cursor-based pagination. Pass the cursor parameter from the previous response to get the next page.

GET /api/v1/decks?limit=20&cursor=550e8400-e29b-41d4-a716-446655440000

The meta.has_more field indicates if additional pages exist. meta.next_cursor provides the cursor value for the next page.

Rate Limits

Default limits are 60 requests per minute and 10,000 requests per day. Rate limit information is included in response headers.

Errors

Error responses include a consistent error object with code and message fields.

{
  "error": {
    "code": "not_found",
    "message": "Deck not found"
  }
}