tasks

Full-text search tasks.

Full-text search over titles and descriptions with typo tolerance (tsvector rank plus trigram word similarity). Scoped by RLS to what the caller can see. q must be at least 2 characters; limit is clamped to 50. Items are the same Task DTO as GET /tasks/{id}, each with its relevance score. MCP sibling: tasks_search.

post/tasks/search

Request

  • Base URL: https://restivity.ai/api/v1
  • URL: https://restivity.ai/api/v1/tasks/search
  • Auth: OAuth 2 (authorization code, authorization URL https://restivity.ai/oauth/authorize, token URL https://restivity.ai/api/oauth/token, scopes: tasks:read)

Request body

qstring required
project_idstring uuid
statusstring[]
include_completedboolean
include_archivedboolean
due_beforestring date-time
due_afterstring date-time
limitinteger
cursorstring
include_seriesboolean

Default false: the search leaves out the template (master) of every materialized recurring series — its occurrences (one task per day, parent_recurrence_id = the master) are matched instead. true also returns the templates. A reminder_only recurring task is searched in every case: there the master is the task.

Response

Matching tasks, best match first.

next_cursorstring nullable required

Always null today — the search is a single page (≤ 50).

Changes

No recorded changes to this operation across all 1 revision of this API.