---
title: "Decide Task Approval"
method: POST
path: "/v1/matters/{matter_id}/tasks/{task_id}/approval/decisions"
tags: ["dashboard"]
---

# Decide Task Approval

`POST /v1/matters/{matter_id}/tasks/{task_id}/approval/decisions`

## 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/matters/{matter_id}/tasks/{task_id}/approval/decisions`
- Auth: HTTP bearer

## Path parameters

- `task_id` string, uuid, required
- `matter_id` string, uuid, required

## Request body

- DecideTaskApproval
  - `request_id` string, uuid, required
  - `outcome` 'approve' | 'return', required
  - `note` string
  - `expected_version` integer, required

## Response `200`

Successful Response

- TaskView
  - `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
  - `description` string, required
  - `notes` string, required
  - `assigned_by` string, uuid, nullable, required
  - `due_date` string, date, nullable, required
  - `calculated_due_date` string, date, nullable, required
  - `due_date_overridden` boolean, required
  - `priority` 'normal' | 'high', required
  - `tool` 'memory' | 'day-ones' | 'file-notes' | 'voidables', nullable, required
  - `state` 'pending' | 'in_progress' | 'completed' | 'not_applicable', required
  - `version` integer, required
  - `source` 'manual' | 'checklist', required
  - `checklist` TaskChecklist, required
    - `id` string, required
    - `pack_id` string, required
    - `phase` 'initial' | 'ongoing' | 'finalisation' | 'other', required
    - `is_heading` boolean, required
    - `title` string, required
    - `description` string, required
    - `task_category` string, required
    - `sub_category` string, required
    - `key_references` string, required
    - `guidance_notes` string, required
    - `due_rule` union, required
      - ChecklistRelativeDateRule
        - `kind` 'relative', required
        - `anchor` union, required
          - string
          - ChecklistEarliestEvent
            - `kind` 'earliest_recorded_event', required
            - `events` string[], required
            - `missing` 'event_pending', required
        - `amount` integer, required
        - `unit` 'business_days' | 'calendar_days' | 'weeks' | 'months' | 'years', required
        - `relation` 'within' | 'after' | 'before' | 'at_least_before', required
        - `cutoff` 'end_of_day', nullable, required
      - ChecklistOnEventDateRule
        - `kind` 'on_event', required
        - `anchor` string, required
      - ChecklistEarliestDateRule
        - `kind` 'earliest_deadline', required
        - `rules` ChecklistRelativeDateRule[], required
          - `kind` 'relative', required
          - `anchor` union, required
            - string
            - ChecklistEarliestEvent
              - …
          - `amount` integer, required
          - `unit` 'business_days' | 'calendar_days' | 'weeks' | 'months' | 'years', required
          - `relation` 'within' | 'after' | 'before' | 'at_least_before', required
          - `cutoff` 'end_of_day', nullable, required
      - ChecklistDeadlinesRule
        - `kind` 'deadlines', required
        - `items` ChecklistDeadline[], required
          - `id` string, required
          - `label` string, required
          - `rule` union, required
            - ChecklistRelativeDateRule
              - …
            - ChecklistOnEventDateRule
              - …
      - ChecklistReceiptDateRule
        - `kind` 'receipt_deadline', required
        - `receipt` string, required
        - `cutoff` ChecklistRelativeDateRule, required
          - `kind` 'relative', required
          - `anchor` union, required
            - string
            - ChecklistEarliestEvent
              - …
          - `amount` integer, required
          - `unit` 'business_days' | 'calendar_days' | 'weeks' | 'months' | 'years', required
          - `relation` 'within' | 'after' | 'before' | 'at_least_before', required
          - `cutoff` 'end_of_day', nullable, required
        - `received_by_cutoff` ChecklistRelativeDateRule, required
          - `kind` 'relative', required
          - `anchor` union, required
            - string
            - ChecklistEarliestEvent
              - …
          - `amount` integer, required
          - `unit` 'business_days' | 'calendar_days' | 'weeks' | 'months' | 'years', required
          - `relation` 'within' | 'after' | 'before' | 'at_least_before', required
          - `cutoff` 'end_of_day', nullable, required
        - `otherwise` ChecklistRelativeDateRule, required
          - `kind` 'relative', required
          - `anchor` union, required
            - string
            - ChecklistEarliestEvent
              - …
          - `amount` integer, required
          - `unit` 'business_days' | 'calendar_days' | 'weeks' | 'months' | 'years', required
          - `relation` 'within' | 'after' | 'before' | 'at_least_before', required
          - `cutoff` 'end_of_day', nullable, required
        - `missing_receipt` 'use_fallback', required
        - `late_receipt` 'does_not_restart_fallback_deadline', required
    - `date_inputs` ChecklistDateInput[], required
      - `key` string, required
      - `anchor` string, required
      - `label` string, required
      - `scope` 'matter' | 'pack_occurrence', required
      - `source_row_id` string, nullable, required
      - `scheduled` boolean, required
      - `optional` boolean, required
    - `record_dates` ChecklistDateInput[], required
      - `key` string, required
      - `anchor` string, required
      - `label` string, required
      - `scope` 'matter' | 'pack_occurrence', required
      - `source_row_id` string, nullable, required
      - `scheduled` boolean, required
      - `optional` boolean, required
    - `sequence_source_ids` string[], required
    - `rule_notes` string[], required
    - `website_links` ChecklistWebsiteLink[], required
      - `label` string, required
      - `url` string, required
    - `tool_links` ChecklistToolLink[], required
      - `tool` 'creditors' | 'date-of-insolvency' | 'day-ones' | 'employees' | 'file-notes' | 'memory' | 'sbr-eligibility' | 'sbr-scenario' | 'searches' | 'voidables', required
      - `label` string, required
      - `route` string, required
      - `template_keys` string[], required
      - `requires` string, nullable, required
      - `available_for` string, nullable, required
    - `source` ChecklistSource, required
      - `workbook` string, required
      - `sheet` string, required
      - `row` integer, required
      - `original_file` string, required
      - `original_sheet` string, required
      - `original_row` integer, required
    - `raw_values` object, required
    - `statutory` boolean, required
  - `activation_id` string, uuid, nullable, required
  - `catalogue_version` string, nullable, required
  - `date_context` string, nullable, required
  - `date_status` 'calculated' | 'awaiting_input' | 'calendar_unavailable' | 'no_rule', required
  - `date_inputs` TaskDateInput[], required
    - `id` string, required
    - `label` string, required
    - `value` string, date, nullable, required
    - `scheduled` boolean, 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
  - `reason` string, required
  - `in_review` boolean, required
  - `assignee_id` string, uuid, nullable, required
  - `assignee_name` string, nullable, required
  - `assignee_email` string, nullable, 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)