Overview

All protected API endpoints require authentication. Superthread supports multiple authentication methods; one of them is a Personal Access Token (PAT). You can create and manage your tokens in your account settings. Include your PAT in the Authorization header as a Bearer token:
 curl  -H "Authorization: Bearer <YOUR_PAT> ...
Any actions taken through the API will be attributed to you individually.

Examples

[GET] Your user details

curl \
  -H "Authorization: Bearer <YOUR_PAT>" \
  https://api.superthread.com/v1/users/me

[POST] Create a new card

curl -X POST \
  -H "Authorization: Bearer <YOUR_PAT>" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My New Card",
    "content": "Some card content...",
    "board_id": "1",
    "list_id": "2"
  }' \
  https://api.superthread.com/v1/{team_id}/cards