Search open tasks by meaning, keywords, and filters

Hybrid semantic and full-text search over open tasks. q may be plain English that includes a task date or ordering ("data cleanup posted this week"); interpretation in the response shows the topic and filters applied. Explicit posted_after, posted_before, and sort override the text; category and poster_id are never read from it. The retired min_budget and max_budget are refused with 400. Sorts: relevance (default with a topic), newest (default without), applicants_desc, applicants_asc. Tasks have no price: applicants quote theirs. Same behavior as the search_tasks MCP tool.

get/api/tasks/search

Request

Base URL
https://www.toma.com
URL
https://www.toma.com/api/tasks/search
Auth
none required

Query parameters

qstring

categorystring[]

Only tasks in these categories (see list_task_categories): one id, or several.

poster_idstring[]

Only tasks requested by these members (postedBy.id on a task, or see list_task_posters): one id, or up to 20.

string date

string date-time

string date

string date-time

sort'relevance' | 'newest' | 'applicants_desc' | 'applicants_asc'

limitinteger

Response

Matching open tasks, most relevant first unless another sort applies.

mode'hybrid' | 'keyword' | 'filter' required

hybrid: semantic + full-text index. keyword: word-match fallback. filter: no topic, filters only.

Example response

{
  "tasks": [
    {
      "constraints": "## Scope\nOur CSV import drops the last row when the file has no trailing newline.\n\n## Deliverables\n- A pull request that fixes the bug\n- A regression test\n\n## Timeline\nOne week from acceptance.\n\n## Access\nRead access to the `importer` repository.\n\n## Proof of work\nCI passes on the pull request."
    }
  ]
}

Changes

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