---
title: "Sections"
method: POST
path: "/v1/workspaces/{workspace_id}/dashboard/sections/search"
tags: ["dashboard"]
---

# Sections

`POST /v1/workspaces/{workspace_id}/dashboard/sections/search`

## Request

- Base URL: `https://api.ender.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ender.au/v1/workspaces/{workspace_id}/dashboard/sections/search`
- Auth: HTTP bearer

## Path parameters

- `workspace_id` string, uuid, required

## Request body

- SectionSearch
  - `search` string
  - `page` integer
  - `matter_id` string, uuid, required
  - `grouping` 'phase' | 'status'
  - `separate_bolt_ons` boolean
  - `state` 'open' | 'completed' | 'all'
  - `due` 'all' | 'today' | 'overdue' | 'week' | 'undated'
  - `source` 'all' | 'manual' | 'checklist'
  - `matter_type` 'all' | 'corporate' | 'bankruptcy'
  - `assignee` 'all' | 'me' | 'unassigned'
  - `sort` 'default' | 'urgency' | 'priority' | 'alphabetical' | 'reverse_alphabetical'
  - `direction` 'asc' | 'desc'

## Response `200`

Successful Response

- TaskSections
  - `groups` TaskGroupPage[], required
    - `items` TaskSummary[], required
      - `assignees` TaskPerson[], required
        - `email` string, nullable, required
        - `id` string, uuid, required
        - `name` string, required
      - `phase` 'initial' | 'ongoing' | 'finalisation' | 'other', required
      - `direct_date_inputs` TaskDateInput[], required
        - `id` string, required
        - `label` string, required
        - `value` string, date, nullable, required
        - `scheduled` boolean, required
      - `id` string, uuid, required
      - `matter_id` string, uuid, required
      - `matter_name` string, required
      - `matter_slug` string, required
      - `title` string, required
      - `due_date` string, date, nullable, required
      - `due_date_overridden` boolean, required
      - `priority` 'normal' | 'high', required
      - `state` 'pending' | 'in_progress' | 'completed' | 'not_applicable', required
      - `version` integer, required
      - `checklist` ChecklistSummary, required
        - `id` string, required
        - `phase` 'initial' | 'ongoing' | 'finalisation' | 'other', required
        - `task_category` string, required
        - `sub_category` string, required
        - `statutory` boolean, required
      - `date_context` string, nullable, required
      - `date_status` 'calculated' | 'awaiting_input' | 'calendar_unavailable' | 'no_rule', required
      - `date_sources` TaskDateSource[], required
        - `task_id` string, uuid, nullable, required
        - `checklist_id` string, required
        - `title` string, required
        - `label` string, nullable, required
        - `date` string, date, nullable, required
        - `awaiting` boolean, required
      - `in_review` boolean, required
      - `assignee_id` string, uuid, nullable, required
      - `assignee_name` string, nullable, required
      - `assignee_email` string, nullable, required
    - `has_more` boolean, required
    - `total_count` integer, required
    - `today` string, date, required
    - `section` string, required
    - `label` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ender/apis/ender-backend.md) - [All operations](https://skmtc.dev/ender/apis/ender-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/ender/apis/ender-backend/revisions/bf4373130521?raw)