---
title: "Search Tasks"
method: GET
path: "/tasks/search"
---

# Search Tasks

`GET /tasks/search`

Search tasks with pagination, sorting, and filtering.

Query params:
    page: Page number (1-based, default 1).
    per_page: Items per page (1-100, default 20).
    sort: Sort field (created_at, priority, title, role, status).
    order: Sort order (asc, desc; default desc).
    status: Filter by task status.
    role: Filter by task role.
    assigned_agent: Filter by assigned agent.

## Query parameters

- `page` integer
- `per_page` integer
- `sort` string
- `order` string
- `status` string, nullable
- `role` string, nullable
- `assigned_agent` string, nullable

## Response `200`

Successful Response

- PaginatedSearchResponse — Paginated task search response with metadata.
  - `tasks` TaskResponse[], required
    - `id` string, required
    - `title` string, required
    - `description` string, required
    - `role` string, required
    - `tenant_id` string, required
    - `priority` integer, required
    - `scope` string, required
    - `complexity` string, required
    - `eu_ai_act_risk` string, required
    - `approval_required` boolean, required
    - `risk_level` string, required
    - `estimated_minutes` integer, nullable, required
    - `status` string, required
    - `depends_on` string[], required
    - `parent_task_id` string, nullable, required
    - `depends_on_repo` string, nullable, required
    - `owned_files` string[], required
    - `assigned_agent` string, nullable, required
    - `result_summary` string, nullable, required
    - `cell_id` string, nullable, required
    - `repo` string, nullable, required
    - `task_type` string, required
    - `upgrade_details` object, nullable, required
    - `model` string, nullable, required
    - `effort` string, nullable, required
    - `cli` string, nullable
    - `batch_eligible` boolean
    - `completion_signals` object[]
    - `slack_context` object, nullable
    - `metadata` object
    - `created_at` number, required
    - `claimed_at` number, nullable
    - `completed_at` number, nullable
    - `closed_at` number, nullable
    - `deadline` number, nullable
    - `progress_log` ProgressEntry[]
      - `timestamp` number, required
      - `message` string, required
      - `percent` integer, required
    - `version` integer
    - `parent_session_id` string, nullable
    - `retry_count` integer
    - `max_retries` integer
    - `retry_delay_s` number
    - `terminal_reason` string, nullable
    - `max_output_tokens` integer, nullable
    - `meta_messages` string[]
    - `max_turns` integer, nullable
  - `total` integer, required
  - `page` integer, required
  - `per_page` integer, required
  - `total_pages` integer, required
  - `sort` string, required
  - `order` string, required
  - `filters` object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sipyourdrink-ltd/apis/bernstein-task-server.md) · [All operations](https://skmtc.net/sipyourdrink-ltd/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sipyourdrink-ltd/bernstein-task-server/versions/86f514b4e920/schema)