---
title: "Worklog changes (v1)"
canonical: "https://support.appfire.com/space/7TFM/2273608559/Worklog%20changes%20(v1)"
format: markdown
---
> Macro (aura-html)

## Endpoint specification

> 📝 Developer documentation is available! This includes endpoint definitions and all current schemas. You can access it here: [Endpoint specification](https://timehubmdy.7pace.com/swagger/index.html?urls.primaryName=7pace+REST+API+v1)

## Actions

```
GET /api/v1/worklogs/changes
```

Retrieve a paginated list of worklog changes, including deleted worklogs, with optional filtering criteria. See **Get** below for more details. 

> ✅ Use the **editedAt.start** and **editedAt.end** to return a list of all changes for a specified timeframe.

## Query parameters

| **Name** | **Type** | **Description** |
| --- | --- | --- |
| before | string | Cursor for pagination of results. Returns results before the specified cursor. |
| after | string | Cursor for pagination of results. Returns results after the specified cursor. |
| externalItemId | array of strings | Filter by external item IDs |
| assigneeId | array of strings | Filter by assignee IDs |
| authorId | array of strings | Filter by author IDs |
| startedAt.start | datetime | Start of worklog date range |
| startedAt.end | datetime | End of worklog date range |
| editedAt.start | datetime | Start of edit date range |
| editedAt.end | datetime | End of edit date range |
| createdAt.start | datetime | Start of create date range |
| createdAt.end | datetime | End of create date range |

### Passing Arrays in Queries

- When passing arrays (e.g., authorId, assigneeId, externalItemId), use comma-separated values:

```
GET /worklogs?authorId=1,2,3,4
```

No need to repeat the parameter. The server automatically splits the values based on commas.

## GET

Retrieve a paginated list of worklogs with optional filtering criteria.

### Returns

| **Name** | **Type** | **Notes** |
| --- | --- | --- |
| id | string | UUID. Does not change. |
| isDeleted | boolean | Flag indicating if the worklog has been deleted. |
| comment | string | Optional text entered by user, typically describing work performed. |
| startedAt | string | Date-time. UTC datetime when the user started the work being logged. |
| createdAt | string | Date-time. UTC datetime when the worklog was created in the system. |
| editedAt | string | Date-time. UTC datetime when the worklog was last modified. |
| assigneeId | string | The monday.com User ID. The user to whom the worklog belongs. |
| authorId | string | The monday.com User ID. The user who originally created the worklog. |
| accountId | string | The monday.com Account ID. |
| editorId | string | The monday.com User ID. The user who last edited the worklog. |
| duration | integer | Total time recorded for the worklog in seconds. |
| externalItemId | string | The monday.com Item ID. The internal, immutable ID for the item associated to the worklog. |
| customFields | ref | See [Custom Fields](https://appfire.atlassian.net/wiki/spaces/7TFM/pages/2253422874). |

### Example response

```
Response (200 OK)
{
    "result": [
        {
            "id": "<id_value>",
            "isDeleted": true,
            "comment": null,
            "duration": 3600,
            "startedAt": "2025-07-07T13:00:00",
            "createdAt": "2025-07-08T22:23:41.756Z",
            "editedAt": "2025-07-08T22:23:41.756Z",
            "assigneeId": <assignee_id>,
            "authorId": <author_id>,
            "accountId": <account_id>,
            "editorId": <editor_id>,
            "externalItemId": "1035962",
            "customFields": {
                "toggle": [],
                "dropdown": []
            }
        },
        {
            "id": "<id_value>",
            "isDeleted": false,
            "comment": "Setup a sandbox environment",
            "duration": 7200,
            "startedAt": "2025-07-07T16:28:01",
            "createdAt": "2025-07-07T22:28:24.108Z",
            "editedAt": "2025-07-07T22:28:24.108Z",
            "assigneeId": "<assignee_id>",
            "authorId": "<author_id>",
            "accountId": "<account_id>",
            "editorId": "<editor_id>",
            "externalItemId": "1035600",
            "customFields": {
                "toggle": [],
                "dropdown": []
            }
        }
    ],
    "_links": {
        "self": {
            "href": "https://timehubmdy.7pace.com/api/v1/worklogs"
        }
    },
    "pageInfo": {
        "startCursor": "MA==",
        "endCursor": "NA==",
        "hasNextPage": false,
        "hasPreviousPage": false
    }
}
```