Create a new task

POST

/tasks

Creates a new task assigned to an employee. Initial status is TODO. Admin only.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Example

{
    "title": "Build Dashboard UI",
    "description": "Create responsive dashboard with charts and analytics",
    "employeeId": "cm5emp001",
    "priority": "HIGH",
    "deadline": "2026-03-01T00:00:00.000Z",
    "skillRequired": "React"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/tasks' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "Build Dashboard UI",
    "description": "Create responsive dashboard with charts and analytics",
    "employeeId": "cm5emp001",
    "priority": "HIGH",
    "deadline": "2026-03-01T00:00:00.000Z",
    "skillRequired": "React"
}'

Responses

🟢201

application/json

Task created successfully

Body

Example

{
    "success": true,
    "data": {
        "id": "cm5task001",
        "orgId": "cm5abc123def456",
        "employeeId": "cm5emp001",
        "title": "Build Dashboard UI",
        "description": "Create responsive dashboard with charts and analytics",
        "status": "TODO",
        "priority": "HIGH",
        "deadline": "2026-03-01T00:00:00.000Z",
        "completedAt": null,
        "txHash": null,
        "skillRequired": "React",
        "createdAt": "2026-02-21T09:00:00.000Z",
        "updatedAt": "2026-02-21T09:00:00.000Z"
    },
    "message": "Task created successfully"
}

🟠404

🟠400ValidationError

Modified at 2026-02-22 18:59:05

List all tasks

Get my tasks