Spellweave.app API

Build apps that interact with Spellweave. Access user collections, decks, and deck statistics through a simple REST API secured by OAuth 2.0.

Quick Start

API Reference

Complete reference for all available endpoints, parameters, and responses.

OAuth 2.0

Authorization Code flow with PKCE. Learn how to authenticate users securely.

Guides

Step-by-step tutorials for common integration patterns.

Example Request

Request

curl https://public-api.spellweave.app/api/v1/me \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "email": "[email protected]",
    "display_name": "CardSlinger",
    "avatar_url": null,
    "created_at": "2026-01-15T10:30:00Z"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-03-31T14:22:00Z"
  }
}

Available Scopes

Scope	Description
`profile:read`	Read user profile information (email, display name)
`collections:read`	Read user card collections and their contents
`collections:write`	Create collections and import cards (subject to plan limits)
`decks:read`	Read user decks, deck cards, and deck statistics