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

# Search TaskGroupSetup

`POST /resource/TaskGroupSetup/QUERY`

## Request

- Base URL: `https://your-subdomain.deputy.deputy.com/api/v1`
- URL: `https://your-subdomain.deputy.deputy.com/api/v1/resource/TaskGroupSetup/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

- TaskGroupSetup[]
  - `Id` integer, required
  - `Key` string, required
  - `Name` string, required
  - `Active` boolean, required
  - `Compulsory` boolean
  - `Notification` string
  - `Deadline` number, double
  - `Plugins` string
  - `Oncreate` string
  - `Onsubmit` string
  - `Comment` string
  - `LaborModel` boolean
  - `Creator` integer, required
  - `Created` string, date-time, required
  - `Modified` string, required

## 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)