Tasklife API Reference

GET /pages/{id}

Fetch a single page by id.

Path parameters

Request example

curl -sS https://api.tasklife.com/v1/pages/776 \
  -H "Authorization: Bearer $API_KEY"

Response 200 OK

The page is nested under data.page.page:

{
  "success": true,
  "data": {
    "page": {
      "page": {
        "id":          776,
        "parent_id":   589,
        "title":       "My Page",
        "content":     "# Heading\nSome **markdown**.",
        "slug":        "my-page",
        "status":      "active",
        "visibility":  "private",
        "version":     1,
        "author_name": "Sal Iozzia",
        "created_at":  "2026-06-15T14:32:11Z",
        "updated_at":  "2026-06-15T14:32:11Z",
        "children":    [],
        "media":       [],
        "attachments": []
      }
    }
  }
}

GET /pages

List pages visible to the API key's org. Soft-deleted pages are excluded.

Query parameters

Request example

curl -sS "https://api.tasklife.com/v1/pages?parent_id=589" \
  -H "Authorization: Bearer $API_KEY"

Response 200 OK

{
  "success": true,
  "data": {
    "pages": [
      {
        "id":         776,
        "title":      "My Page",
        "slug":       "my-page",
        "parent_id":  589,
        "status":     "active",
        "visibility": "private",
        "created_at": "2026-06-15T14:32:11Z",
        "updated_at": "2026-06-15T14:32:11Z"
      }
    ],
    "pagination": { "limit": 50, "offset": 0, "total": 1 }
  }
}

GET /search?q=…

Full-text search across page titles and bodies. Multi-word queries match pages containing all terms (AND).

Query parameters

Request example

curl -sS "https://api.tasklife.com/v1/search?q=realtime+pubsub" \
  -H "Authorization: Bearer $API_KEY"

Response 200 OK

{
  "success": true,
  "data": {
    "matches": [
      {
        "id":        776,
        "parent_id": 589,
        "title":     "Realtime pubsub plan",
        "slug":      "realtime-pubsub-plan",
        "content":   "# Heading\nSome **markdown**."
      }
    ]
  }
}

GET /pages/tree

Return the full page hierarchy as a nested tree. Each node carries the same shape as a single page response, with children recursively populated.

Request example

curl -sS https://api.tasklife.com/v1/pages/tree \
  -H "Authorization: Bearer $API_KEY"

Response 200 OK

{
  "success": true,
  "data": {
    "tree": [
      {
        "id": 589, "title": "Engineering", "slug": "engineering", "parent_id": null,
        "children": [
          { "id": 776, "title": "My Page", "slug": "my-page", "parent_id": 589, "children": [] }
        ]
      }
    ]
  }
}

GET /pages/{id}/versions

List the version history of a page. Every successful PUT writes a snapshot before applying the change.

Path parameters

Request example

curl -sS https://api.tasklife.com/v1/pages/776/versions \
  -H "Authorization: Bearer $API_KEY"

Response 200 OK

{
  "success": true,
  "data": {
    "versions": [
      { "version": 2, "title": "My Page",            "content": "# New body",       "created_by": 1, "created_at": "2026-06-15T15:00:00Z" },
      { "version": 1, "title": "My Page",            "content": "# Original body",  "created_by": 1, "created_at": "2026-06-15T14:32:11Z" }
    ]
  }
}

GET /pages/{id}/diff

"What's new" diff, the API/MCP equivalent of the Pages View changes button. Compares the visible text (markdown/HTML stripped) of two versions. Version N is the page state before the write recorded at that version's at/by; the live page is current (latest snapshot + 1). MCP tool: get_page_diff (page_id, from_version, to_version, since).

Query parameters

Request example

curl -sS "https://api.tasklife.com/v1/pages/832/diff?from=3" \
  -H "Authorization: Bearer $API_KEY"

Response 200 OK

{
  "success": true,
  "data": { "diff": {
    "page_id": 832, "title": "My Page", "current_version": 4,
    "from": { "version": 3, "current": false, "title": "My Page", "at": "2026-10-01T15:00:00Z", "by": 1, "by_name": "Sal" },
    "to":   { "version": 4, "current": true,  "title": "My Page", "at": "2026-10-01T16:00:00Z", "by": 1, "by_name": "Sal" },
    "summary": { "additions": 6, "removals": 2, "title_changed": false, "words_before": 120, "words_after": 124 },
    "mode": "word", "too_large": false, "truncated": false,
    "changes": [
      { "type": "equal", "text": "... last words of unchanged context" },
      { "type": "del",   "text": "old words" },
      { "type": "add",   "text": "new words" }
    ],
    "unified": "@@ -10,4 +10,4 @@\n context\n-old words\n+new words\n"
  } }
}

Flags: too_large (content over the size cap; only title + word counts returned), truncated (segments capped), no_baseline (no earlier version yet). mode is word, block (large-content fallback) or none.