Tasks API

The Tasks public API provides CRUD endpoints for tasks, addressed by externalId. Tasks belong to a project.

List tasks

GET /api/v1/tasks

Returns all tasks in the tenant.

curl "https://app.dimesheets.com/api/v1/tasks" \
  -H "X-API-KEY: {your-api-key}"

Example response

[
  {
    "id": 10,
    "externalId": "task-200",
    "tenantId": "tenant-abc",
    "projectId": 3,
    "name": "Backend API development",
    "description": "Implement REST endpoints",
    "dueDate": "2026-05-01T00:00:00Z",
    "estimatedHours": 40.0,
    "actualHours": 12.5,
    "isBillable": true,
    "assigneeUserIds": [5, 8],
    "createdAt": "2026-04-01T09:00:00Z",
    "updatedAt": "2026-04-08T14:30:00Z"
  }
]

Get a task

GET /api/v1/tasks/{externalId}

Returns the task matching the given external ID, or 404 Not Found.

Create a task

POST /api/v1/tasks

Request body

{
  "externalId": "task-201",
  "projectId": 3,
  "name": "Design system components",
  "description": "Build shared UI component library",
  "estimatedHours": 24.0,
  "isBillable": true
}

Returns 201 Created with the new task, or 400 Bad Request.

Update a task

PUT /api/v1/tasks/{externalId}

Returns 200 OK with the updated task, or 404 Not Found.

Delete a task

DELETE /api/v1/tasks/{externalId}

Returns 204 No Content, or 404 Not Found.

Task model

Field	Type	Description
`id`	int	Internal ID
`externalId`	string	Stable external identifier
`tenantId`	string	Tenant ID
`projectId`	int	Parent project ID
`name`	string	Task name
`description`	string	Task description
`dueDate`	datetime?	Due date
`estimatedHours`	number	Estimated hours
`actualHours`	number	Actual hours logged
`isBillable`	boolean	Whether time logged to this task is billable
`assigneeUserIds`	int[]	IDs of assigned users
`createdAt`	datetime	Creation timestamp
`updatedAt`	datetime	Last update timestamp

Tasks API

On this page