Getting Started

Quick start guide: register, login, and make your first API call

Step 1: Register or Login

Create an account or login to receive a JWT token

# Register a new account
mutation Register {
  register(email: "user@example.com", password: "secret123", name: "Anna") {
    token
    user { id email name createdAt }
  }
}

# Or login with existing account
mutation Login {
  login(email: "user@example.com", password: "secret123") {
    token
    user { id email name }
  }
}

Step 2: Add Authorization Header

Use the token from login/register response in all subsequent requests

# In GraphiQL / Playground, add to HTTP Headers:
{
  "Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Step 3: Typical Workflow

Follow this order to work with the API

# 1. Check current user
query Me {
  me { id email name }
}

# 2. Get or create a board
query Boards {
  boards(first: 10) {
    edges {
      node { id title }
    }
  }
}

# 3. Get board columns
query Columns($boardId: ID!) {
  columns(boardId: $boardId) {
    id
    title
    position
  }
}

# 4. Get or create tasks
query TasksByBoard($boardId: ID!) {
  tasksByBoard(boardId: $boardId, first: 20) {
    edges {
      node {
        id
        title
        priority
        columnId
      }
    }
  }
}

💡 All mutations and protected queries require the Authorization header with a valid JWT token