Skip to content

Work item worklogs overview ​

Worklogs record time spent on a work item.

The worklog object ​

Attributes ​

  • created_at string (date-time)

    When the record was created.

  • created_by_id string (uuid)

    The user who created the record.

  • description string

    Free-form description.

  • duration integer

    Time logged, in minutes.

  • id string (uuid)

    Unique identifier.

  • logged_by_id string (uuid)

    The related logged by.

  • updated_at string (date-time)

    When the record last changed.

  • work_item_id string (uuid)

    The related work item.

Response200
json
{
  "created_at": "2026-01-14T09:22:41.478363Z",
  "created_by_id": "16c61a3a-512a-48ac-b0be-b6b46fe6f430",
  "description": "What this is for.",
  "duration": 90,
  "id": "b7e42a19-3c5d-4f80-9a26-8d1c0f4e7b53",
  "logged_by_id": "f960d3c2-8524-4a41-b8eb-055ce4be2a7f",
  "updated_at": "2026-01-14T09:22:41.478363Z",
  "work_item_id": "f960d3c2-8524-4a41-b8eb-055ce4be2a7f"
}

Endpoints ​

MethodPathDescription
GET/api/v2/workspaces/{slug}/projects/{project_id}/work-items/{work_item_id}/worklogs/List worklogs
GET/api/v2/workspaces/{slug}/projects/{project_id}/worklogs/summary/Get the project worklog summary
GET/api/v2/workspaces/{slug}/projects/{project_id}/work-items/{work_item_id}/worklogs/{pk}/Get a worklog
POST/api/v2/workspaces/{slug}/projects/{project_id}/work-items/{work_item_id}/worklogs/Create a worklog
PATCH/api/v2/workspaces/{slug}/projects/{project_id}/work-items/{work_item_id}/worklogs/{pk}/Update a worklog
DELETE/api/v2/workspaces/{slug}/projects/{project_id}/work-items/{work_item_id}/worklogs/{pk}/Delete a worklog

Response shaping ​

Every worklog read accepts ?fields= for sparse responses — see Sparse fields. Errors follow the shared problem+json contract.