Deadlines

A deadline (internally a "happening") is the thing Dociya exists to never let slip — a renewal, a payment, a filing window. Most are extracted automatically from a document; some are created directly.

List deadlines

GET/deadlines

Every deadline in the household, most-urgent-first.

Parameters

statusstringoptional

Defaults to "active". Also accepts snoozed, completed.

curl "https://api.dociya.com/deadlines?status=active" \
  -H "Authorization: Bearer $DOCIYA_ACCESS_TOKEN"

Snooze a deadline

POST/deadlines/:id/snooze

Pushes the next nudge out without marking the deadline done.

Parameters

untilstring (date)required

curl https://api.dociya.com/deadlines/8a91.../snooze \
  -H "Authorization: Bearer $DOCIYA_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "until": "2027-01-01" }'

Get a renewal guide

GET/deadlines/:id/renewal-guide

A web-grounded, step-by-step guide for renewing this specific thing — cached after first generation. Every step traces back to a real source; nothing is invented.

Parameters

refreshbooleanoptional

Force-regenerate instead of serving the cached guide.

curl https://api.dociya.com/deadlines/8a91.../renewal-guide \
  -H "Authorization: Bearer $DOCIYA_ACCESS_TOKEN"

Also on this resource

POST /deadlinesCreate a deadline directly (not extracted from a document).

POST /deadlines/:id/completeMark done.

GET /deadlines/:id/conversationThe conversation thread this deadline lives in.

GET /deadlines/:id/checklist · POST .../checklist/:itemId/toggleThe renewal checklist for this specific deadline — pack-templated steps.