---
title: "Create Task"
method: POST
path: "/tasks"
---

# Create Task

`POST /tasks`

## Request

- Base URL: `https://api.roapp.io/v2`
- URL: `https://api.roapp.io/v2/tasks`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/roapp/apis/ro-app-public-api-v2/docs/tasks/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new task.

## Request body

- object
  - `title` string, required: Task title
  - `description` string: Task description
  - `priority` 'low' | 'medium' | 'high': Task priority
  - `due_date` string, required: Task due date (example: "2026-10-29" or "2026-10-29T12:00:00Z")
  - `assignee_ids` number[]: Array of Employee IDs
  - `related_object` object: Related Object
    - `type` 'task' | 'inquiry' | 'order' | 'invoice' | 'client', required: Object Type
    - `id` number, required: Object ID

## Response `200`

200

- object

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `df0f57c15ea0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roapp/apis/ro-app-public-api-v2/changes/tasks/post.md)

---

[API](https://skmtc.dev/roapp/apis/ro-app-public-api-v2.md) - [All operations](https://skmtc.dev/roapp/apis/ro-app-public-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/roapp/apis/ro-app-public-api-v2/revisions/df0f57c15ea0?raw)