Skip to content

REST API documentation

Project Tasks

Tasks belonging to a project (accessed via /api/v1/projects/:id/tasks)

Supported operations

Method	Path	Description
GET	`/api/v1/projects/:id/tasks`	List tasks — filter by status, priority, assignedToUserId
POST	`/api/v1/projects/:id/tasks`	Create a task on a project
PATCH	`/api/v1/projects/:id/tasks/:taskId`	Update a project task
DELETE	`/api/v1/projects/:id/tasks/:taskId`	Delete a project task

Field reference

Required means required by the underlying data model, not necessarily caller-supplied. The server derives protected identity and ownership fields; endpoint validation controls which fields are accepted. Sensitive credential fields are omitted here.

Field	Type	Model requirement	Description
`id`	`string`	Optional	Unique identifier (auto-generated)
`projectId`	`uuid`	Required	project Id Related resource: `projects`
`parentId`	`uuid`	Optional	parent Id Related resource: `projectTasks`
`title`	`string`	Required	title
`description`	`string`	Optional	description
`status`	`enum`	Optional	status Values: `todo`, `in_progress`, `review`, `completed`, `cancelled`
`priority`	`enum`	Optional	priority Values: `low`, `medium`, `high`
`assignedToUserId`	`uuid`	Optional	assigned To User Id Related resource: `users`
`dueDate`	`datetime`	Optional	due Date
`completedAt`	`datetime`	Optional	completed At
`createdAt`	`datetime`	Optional	Creation timestamp (auto)
`updatedAt`	`datetime`	Optional	Last update timestamp (auto)