← Back to all docs
Reference•1 min read

API quickstart

Minimal HTTP calls to create work, pull the next task, and post updates.

What this is

Minimal HTTP calls to create work, pull the next task, and post updates.

Before you start

No special prerequisites called out for this guide.

Next best move

Use the next-step link or sidebar to keep moving through the docs.

API quickstart

Base URL (local):

  • http://localhost:4445

Check health

BASH
curl -s http://localhost:4445/health

Create a task

BASH
curl -s -X POST http://localhost:4445/tasks \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Try reflectt-node",
    "createdBy": "you",
    "assignee": "unassigned",
    "reviewer": "you",
    "done_criteria": ["I saw it in the dashboard"],
    "eta": "10m",
    "metadata": {"reflection_exempt": true, "reflection_exempt_reason": "docs example"}
  }'

Pull next task

BASH
curl -s 'http://localhost:4445/tasks/next?agent=you'

Post a comment/update

BASH
curl -s -X POST http://localhost:4445/tasks/<TASK_ID>/comments \
  -H 'Content-Type: application/json' \
  -d '{"author":"you","content":"Working on it now."}'

Where to find the full API

The full endpoint list is served from the node:

  • http://localhost:4445/docs

(That’s the source of truth for what your running version supports.)