PARA

Get PARA tree

GET /api/v1/para/tree

Returns the full PARA hierarchy with categories and items.

---

List PARA items

GET /api/v1/para

Parameter	Type	Default	Description
category	string	—	Filter: projects, areas, or resources
status	string	—	Filter: active or archived

---

Get PARA item

GET /api/v1/para/:id

Returns a single PARA item with label, description, slug, and status.

---

Create PARA item

POST /api/v1/para
Content-Type: application/json

{
  "category": "projects",
  "label": "My Project",
  "description": "Optional description"
}

Slug is auto-generated from label. Returns 201 with the created item.

Creating a PARA item triggers background reclassification of orphan nodes.

---

Update PARA item

PATCH /api/v1/para/:id
Content-Type: application/json

Accepts partial updates to label, description, and status.

---

Complete / Undo complete

POST /api/v1/para/:id/complete
POST /api/v1/para/:id/undo-complete

Mark a project as completed or revert it to active.

---

Archive / Unarchive

POST /api/v1/para/:id/archive
POST /api/v1/para/:id/unarchive

Archive sets status to archived and archives all node-tag associations. Unarchive restores them. Both are idempotent.

---

Delete (deprecated)

DELETE /api/v1/para/:id

Returns 410 Gone. Use archive instead.

---

Trigger reclassification

POST /api/v1/para/:id/match

Triggers background matching to find and assign orphan nodes that match this PARA item.

---

Rescan orphans

POST /api/v1/para/rescan

Re-classify all orphan nodes against the current PARA structure. Rate limited to once per 5 minutes per tenant.

Returns { "queued": <count> } with the number of nodes queued for reclassification.