List Record Activity

POST /v1/list-record-activity

Read the full history of a single record — its comments and its actions (field changes, moves, assignments, status changes). Use this to understand how a record reached its current state.

Request body

Field	Type	Required	Description
`workspaceId`	string	Yes	The workspace ID the record belongs to
`recordId`	string	Yes	The record ID
`type`	`all` \| `comments` \| `actions`	No	Filter to comments only, actions only, or all (default: all)
`limit`	number	No	Maximum items, max 24 (default: 20)
`skip`	number	No	Offset for pagination (default: 0)

{
  "workspaceId": "string",
  "recordId": "string",
  "type": "all",
  "limit": 0,
  "skip": 0
}

Response

{
  "items": [
    {
      "__typename": "string",
      "id": "string",
      "html": "string",
      "createdAt": "2024-01-01T00:00:00Z",
      "deletedAt": "2024-01-01T00:00:00Z",
      "commentUser": {
        "id": "string",
        "fullName": "string"
      },
      "type": "UPDATE_TITLE",
      "oldValue": "string",
      "newValue": "string",
      "automated": true,
      "actionUser": {
        "id": "string",
        "fullName": "string"
      },
      "affectedBy": {
        "id": "string",
        "fullName": "string"
      },
      "customField": {
        "id": "string",
        "name": "string"
      }
    }
  ],
  "totalCount": 0
}

Example

curl -X POST https://rest.blue.app/v1/list-record-activity \
  -H "Authorization: Bearer $BLUE_TOKEN" \
  -H "blue-org-id: $BLUE_ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"workspaceId":"string","recordId":"string","type":"all","limit":0,"skip":0}'