Skillion API

Your first call#

1. 1

   Get your key in the app: Settings → tap the version 7 times → Developer API. Step by step, in detail

   Heads up

   You need Skillion Premium and a registered account (not a guest one). Without Premium the row shows a lock and opens the paywall.

2. 2

   Ask for your profile:

   curlCopy

   export SKILLION_KEY="sk_live_…"   # yours, from the app
   
   curl https://api.skillion.app/functions/v1/api/v1/me \
     -H "Authorization: Bearer $SKILLION_KEY"

3. 3

   You get your level, XP, coins and energy, and your limits:

   Response · example

   {
     "data": {
       "level": 7,
       "total_xp": 140,
       "xp_to_next_level": 350,
       "coins": 820,
       "energy_points": 64,
       "max_energy": 100,
       "health_points": 100,
       "max_health": 100,
       "nickname": "Luna",
       "updated_at": "2026-10-21T18:00:00Z"
     },
     "limits": { "per_minute": 120, "per_day": 10000, "page_max": 100 }
   }

Get your key#

1. 1

   Open Skillion and go to Settings.

2. 2

   Scroll to the bottom and tap the line «Version …» seven times in a row, with less than 2 seconds between taps. Your phone vibrates and you see «Developer options unlocked».

3. 3

   A new row appears in Settings: «Developer API». Open it.

4. 4

   Tap «Create key», give it a name and tap «Create». Then tap «Copy»: the key is shown only once. You can have up to 5 active keys and revoke any of them on that screen.

Authentication#

Send the key as a Bearer token on every request. All bodies are JSON.

curl https://api.skillion.app/functions/v1/api/v1/me \
  -H "Authorization: Bearer sk_live_…"

Completing a task is not instant#

Pact tasks are completed with a check-in in the app and bad habits are never completed: both answer 409.

Endpoints#

Lists and paging#

Lists come oldest change first. Pass next_cursor back as cursor until it is null. Deleted and archived items are left out unless you ask for them.

Task fields you can set#

Only title is required. Anything else (XP, level, status, coins earned) is calculated by the app and is read-only. Unknown fields are refused with 422, so a typo never goes unnoticed.

Skill fields you can set#

level, total_xp (the XP inside the current level) and the streaks are read-only. Free accounts keep 3 active skills, but the API itself is Premium only.

Routines and their blocks#

A routine is a day plan of the time blocking screen («Monday», «Work day»…) with its blocks inside. Plan a whole week with seven POST /v1/routines, one per day.

Routine

Each block in blocks

blocks is always the whole list: a block with id is updated, one without id is created and any block you leave out is deleted. Leave blocks out of a PATCH to keep them as they are. Blocks come back with start_time and end_time («07:30») to read them easily.

Errors#

Errors always have the same shape. details lists each field that was not valid.

{
  "error": {
    "code": "invalid_field",
    "message": "Some fields are not valid.",
    "details": { "custom_days": "must be weekdays like \"1,3,5\" …" }
  }
}

Limits#

120 requests per minute

per account, all your keys together

10,000 requests per day

per account, the day resets at 00:00 UTC

100 items per page

default 50

64 KB per body

Over a limit you get 429 with a retry-after header (seconds). Every answer carries x-ratelimit-limit and x-ratelimit-remaining.

Deleting#

DELETE does what the app does: skills and recurring tasks are archived (their history stays), one-off tasks are deleted, and a routine is deleted with its blocks. Either way they disappear from your phone on its next sync.

Good to know#

• Changes reach your phone on its next sync, usually when you open the app.
• If you edit the same task on your phone before it syncs, the phone wins.
• Recurring tasks get their next due date from your phone, which knows your time zone and daily reset hour.
• Dates are ISO 8601 with a time zone, for example 2026-10-21T18:00:00Z.

Examples#

Create a recurring task linked to a skill

curl -X POST https://api.skillion.app/functions/v1/api/v1/tasks \
  -H "Authorization: Bearer $SKILLION_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Gym",
    "is_recurring": true,
    "recurrence_pattern": "custom",
    "custom_days": "1,3,5",
    "difficulty": "hard",
    "skills": [{ "skill_id": "<skill id>", "xp": 20 }]
  }'

Complete it (from a shortcut, a cron, a button)

curl -X POST https://api.skillion.app/functions/v1/api/v1/tasks/<task id>/complete \
  -H "Authorization: Bearer $SKILLION_KEY"

# 202 → { "data": { "id": "…", "status": "pending", … } }

Read everything that changed since yesterday

const since = new Date(Date.now() - 86_400_000).toISOString()
let cursor = null
do {
  const url = new URL('https://api.skillion.app/functions/v1/api/v1/tasks')
  url.searchParams.set('updated_since', since)
  if (cursor) url.searchParams.set('cursor', cursor)
  const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.SKILLION_KEY}` } })
  const page = await res.json()
  for (const task of page.data) console.log(task.title, task.status)
  cursor = page.next_cursor
} while (cursor)

Plan your week: one routine per day

const days = ['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday']
for (const name of days) {
  const weekend = name === 'Saturday' || name === 'Sunday'
  const res = await fetch('https://api.skillion.app/functions/v1/api/v1/routines', {
    method: 'POST',
    headers: { Authorization: `Bearer ${process.env.SKILLION_KEY}`, 'Content-Type': 'application/json' },
    body: JSON.stringify({
      name,
      blocks: [
        { start_minute: weekend ? 540 : 420, duration_minute: 30, title: 'Read' },
        { start_minute: 1080, duration_minute: 60, title: 'Gym', color: '#F29092' },
        { start_minute: 1380, duration_minute: 60, title: 'Wind down' },
      ],
    }),
  })
  if (!res.ok) console.error(name, (await res.json()).error)
}