---
title: "Add a task"
method: POST
path: "/tasks"
tags: ["task"]
---

# Add a task

`POST /tasks`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/tasks`
- Auth: HTTP bearer

## Request body

- object
  - `title` string, required
  - `owner_member_id` string
  - `due_date` string, date
  - `note` string

## Response `200`

The result.

- object
  - `id` string, required
  - `title` string, required
  - `owner_member_id` string, nullable, required
  - `due_date` string, date, nullable, required
  - `status` 'open' | 'done' | 'not_applicable', required
  - `source` union, required
    - object
      - `kind` 'rule', required
      - `rule_id` string, required
      - `version` string, required
    - object
      - `kind` 'document', required
      - `document_id` string, required
    - object
      - `kind` 'template', required
      - `template_key` string, required
      - `version` string, required
    - object
      - `kind` 'person', required
      - `created_by` string, required
    - object
      - `kind` 'application', required
      - `application_id` string, required
    - object
      - `kind` 'employment', required
      - `party_id` string, required
    - object
      - `kind` 'employment_change', required
      - `party_ids` string[], required
    - object
      - `kind` 'departure', required
      - `party_ids` string[], required
  - `note` string, nullable, required
  - `resolves_via` string, nullable, required
  - `resolution` string, nullable, required
  - `evidence_document_ids` string[], required
  - `resolved_by` string, nullable, required
  - `resolved_at` string, date-time, nullable, required
  - `overdue` boolean, required
  - `created_at` string, date-time, required

## Other responses

- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)
