---
title: "Search Task"
method: POST
path: "/resource/Task/QUERY"
tags: ["Task"]
---

# Search Task

`POST /resource/Task/QUERY`

## Request

- Base URL: `https://your-subdomain.deputy.deputy.com/api/v1`
- URL: `https://your-subdomain.deputy.deputy.com/api/v1/resource/Task/QUERY`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://once.deputy.com/my/oauth/login`
    - Token URL: `https://once.deputy.com/my/oauth/access_token`

Flexible search endpoint. Body supports `search`, `sort`, `start`, `max`, and `join` clauses. Example: `{"search": {"s1": {"field": "Id", "data": 1, "type": "eq"}}}`.

## Request body

- QueryRequest: V1 Resource search payload. All fields optional; an empty body returns the first page of results.
  - `search` object: Map of search clauses keyed by an arbitrary id (e.g. `s1`, `s2`). Each clause filters one field.
  - `sort` object: Map of field name → `asc` or `desc`.
  - `start` integer: Pagination offset (0-indexed).
  - `max` integer: Max records per page (server caps at 500).
  - `join` string[]: Related ORMs to expand inline (e.g. `["EmployeeObject"]`).

## Response `200`

Success

- Task[]
  - `Id` integer, required
  - `TaskSetupId` integer, required
  - `OpUnitId` integer, required
  - `GroupId` integer, required
  - `DayTimestamp` integer, required
  - `Date` string, date-time, required
  - `OrigDayTimestamp` integer
  - `OrigDate` string, date-time
  - `AvailableAfterTimestamp` integer
  - `DueDate` string, date-time
  - `DueTimestamp` integer
  - `RepeatIfNotCompleted` boolean
  - `SortOrder` integer, required
  - `Type` integer
  - `Question` string, required
  - `Answer` string
  - `Comment` string
  - `UserEntry` integer, required
  - `UserPerformTask` integer
  - `UserResponsible` integer
  - `Created` string, date-time, required
  - `Modified` string, required
  - `TsCompleted` integer
  - `Start` integer
  - `End` integer
  - `Duration` integer
  - `TaskSetup` object
  - `OpUnit` object
  - `Group` object

## Other responses

- `400`: Bad request
- `401`: Authentication required or invalid token
- `403`: Forbidden — token lacks access to this resource
- `404`: Resource not found

---

[API](https://skmtc.dev/deputy/apis/deputy-v1-resource-api.md) - [All operations](https://skmtc.dev/deputy/apis/deputy-v1-resource-api/llms.txt) - [OpenAPI document](https://skmtc.dev/deputy/apis/deputy-v1-resource-api/revisions/5d8e44000786?raw)