Create a task

Creates a new task inside an existing project. Requires a valid project_id obtained from POST /projects. Tasks are created with a default status of pending.

POST /tasks

Create a task

cURL

curl --request POST \
  --url https://test-writechoice.onrender.com/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "title": "Write introduction page",
  "description": "Draft the overview and getting started sections."
}
'

201

{
  "task_id": "f9e8d7c6-b5a4-3210-fedc-ba9876543210",
  "project_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "title": "Write introduction page",
  "description": "Draft the overview and getting started sections.",
  "status": "pending",
  "created_at": "2025-05-12T10:35:00.000Z",
  "updated_at": "2025-05-12T10:35:00.000Z"
}

Authorizations

Authorization · string · header · required

All requests must include a valid API key in the Authorization header. Example: Authorization: Bearer tf-live-4a8f2c1e9b3d7e6a

Body

application/json

project_id · string<uuid> · required

The ID of the project to add the task to. Required.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

title · string · required

The title of the task. Required.

Example:

"Write introduction page"

description · string

An optional description of the task.

Example:

"Draft the overview and getting started sections."

Response

201

application/json

Task created successfully.

task_id · string<uuid>

Unique identifier for the task. Generated automatically.

Example:

"f9e8d7c6-b5a4-3210-fedc-ba9876543210"

project_id · string<uuid>

The ID of the project this task belongs to.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

title · string

The title of the task.

Example:

"Write introduction page"

description · string | null

An optional description of the task.

Example:

"Draft the overview and getting started sections."

status · enum<string>

The current status of the task. - pending: The task has not been started. - in_progress: The task is actively being worked on. - done: The task has been completed.

Available options: pending, in_progress, done

Example:

"pending"

created_at · string<date-time>

Timestamp of when the task was created.

Example:

"2025-05-12T10:35:00.000Z"

updated_at · string<date-time>

Timestamp of the last update to the task.

Example:

"2025-05-12T11:00:00.000Z"