※ 現在APIはベータ版です。仕様が変更になる可能性がありますのでご了承ください。

GET /api/v1/search/tasks >>>
Find tasks by queries

Examples

GET /api/v1/search/tasks
200
{
  "tasks": [
    {
      "id": 766,
      "key": "http://bergstrom.example/dewayne",
      "title": "Omnis ut et vel.",
      "url": "http://bergstrom.example/dewayne",
      "team_id": 363,
      "created_at": "2025-10-21T11:07:04.000+09:00",
      "updated_at": "2025-10-21T11:07:04.000+09:00",
      "deleted_at": null,
      "description": null,
      "category": {
        "id": 765,
        "key": "key1",
        "title": "key1",
        "url": null,
        "team_id": 363,
        "created_at": "2025-10-21T11:07:04.000+09:00",
        "updated_at": "2025-10-21T11:07:04.000+09:00",
        "deleted_at": null,
        "description": null,
        "category": true,
        "sequential_id": null,
        "state": "open",
        "bill": 0,
        "ancestry": null,
        "ancestry_depth": 0,
        "closed_at": null,
        "color": 1,
        "position": 2,
        "deleted_at_seconds": 0,
        "key_md5": "c2add694bf942dc77b376592d9c862cd",
        "archived": false,
        "category_id": null,
        "ancestry_path": "/",
        "selectable": true,
        "ancestor_titles": []
      },
      "sequential_id": null,
      "state": "open",
      "bill": 0,
      "ancestry": "765",
      "ancestry_depth": 1,
      "closed_at": null,
      "color": 1,
      "position": null,
      "deleted_at_seconds": 0,
      "key_md5": "0af89cedfc3f3c28452e7459ddc48f42",
      "archived": false,
      "category_id": 765,
      "ancestry_path": "/765/",
      "selectable": true,
      "team": {
        "id": 363,
        "name": "Maryland dragons",
        "created_at": "2025-10-21T11:07:04.000+09:00",
        "updated_at": "2025-10-21T11:07:05.000+09:00",
        "deleted_at": null,
        "time_limit": 0,
        "avatar": null,
        "ancestry": null,
        "hierarchized": false,
        "default_duration": 15,
        "tasks_readonly_role": "none",
        "workspaces_workspace_id": 486,
        "tasks_readonly": false,
        "rounding": "floor",
        "capacity": null,
        "premium": false,
        "personal": false,
        "avatar_url": "data:image/png;base64,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"
      },
      "total_time": "00:00:00"
    }
  ],
  "is_last_page": true
}

Params

Param name Description
title
required

Filter tasks based on whether they’re team_id.

Validations:

  • Must be a String

team_id
optional

Filter tasks based on whether they’re team_id.

Validations:

  • Must be a number.

category_id
optional

Filter tasks based on whether they’re category_id.

Validations:

  • Must be a number.

state
optional

Filter tasks based on whether they’re one of open, closed, trashed or all. Default: open

Validations:

  • Must be one of: open, closed, trashed, all.

page
optional

Validations:

  • Must be a number.

limit
optional

Validations:

  • Must be a number.