Workspace Activity

Use the activityList query to read the activity feed — the chronological audit trail of actions that happened in a workspace or across an organization (records created, comments posted, users invited, lists moved, and so on). Workspaces are Workspace objects and organizations are Organization objects in the API; activity entries are Activity objects.

Activities are generated automatically by the server — there is no mutation to create one. This query is the read side; for a live stream of new activity over WebSocket, use the subscribeToActivity subscription.

Request

The smallest useful call scopes the feed to one workspace and takes the most recent page. The feed is always scoped to the organization in your blue-org-id header — see Permissions.

query WorkspaceActivity {
  activityList(projectId: "project_123", first: 20) {
    activities {
      id
      category
      html
      createdAt
      createdBy {
        id
        fullName
        email
      }
    }
    pageInfo {
      hasNextPage
    }
    totalCount
  }
}

projectId accepts a workspace ID or slug. Omit it to read the organization-wide feed across every workspace you can see.

Parameters

All arguments are optional. With no arguments, activityList returns the most recent 20 entries across your accessible workspaces in the organization bound by your blue-org-id header.

ActivityCategory

The category of an activity. The full enum:

ActivityOrderByInput

Sort order. createdAt_DESC (newest first) is the default and the usual choice for a feed.

The enum also accepts id_*, uid_*, inviteeEmail_*, metadata_*, and userAccessLevel_* (each in _ASC / _DESC), but those are rarely useful for a chronological feed.

Response

{
  "data": {
    "activityList": {
      "activities": [
        {
          "id": "clm4n8qwx000008l0g4oxdqn7",
          "category": "CREATE_TODO",
          "html": "<b>Ada Lovelace</b> created the record <b>Draft Q3 roadmap</b>",
          "createdAt": "2026-05-29T14:22:05.000Z",
          "createdBy": {
            "id": "clm4n8qwx000108l0a1b2c3d4",
            "fullName": "Ada Lovelace",
            "email": "ada@example.com"
          }
        }
      ],
      "pageInfo": { "hasNextPage": true },
      "totalCount": 20
    }
  }
}

ActivityList

Activity

Select User subfields by name — the type exposes fullName, firstName, lastName, username, and email; there is no name field.

Full example

Read every record-creation and completion event in one workspace from a single user during March 2026, oldest first, paging in batches of 50.

query WorkspaceActivityFiltered {
  activityList(
    projectId: "project_123"
    userIds: ["user_123"]
    categories: [CREATE_TODO, MARK_TODO_AS_COMPLETE]
    startDate: "2026-03-01T00:00:00Z"
    endDate: "2026-03-31T23:59:59Z"
    first: 50
    orderBy: createdAt_ASC
  ) {
    activities {
      id
      category
      html
      createdAt
      createdBy {
        id
        fullName
      }
      affectedBy {
        id
        fullName
      }
      todo {
        id
        title
      }
      project {
        id
        name
        slug
      }
    }
    pageInfo {
      hasNextPage
    }
    totalCount
  }
}

To fetch the next page, pass the id of the last entry as after: "<last-id>" and keep the other arguments unchanged.

Errors

A workspace you cannot see, an archived workspace, or one with activity tracking disabled does not error — those activities are silently excluded from the feed.

Permissions

The feed is scoped to the organization in your blue-org-id header and to the workspaces you belong to within it; a companyId argument cannot widen that scope.

• You only see activities from workspaces you are a member of and that have activity tracking enabled. Entries from before you joined the organization are excluded.
• Activities that reference a custom field your role cannot view are filtered out, unless you are an organization OWNER or ADMIN.
• Membership-change categories (REMOVE_USER_FROM_PROJECT, LEAVE_PROJECT, REMOVE_USER_FROM_COMPANY, LEAVE_COMPANY) are only visible to workspace or organization admins. In the organization-wide feed, REMOVE_TODO entries are also hidden.

Related

• Stream live activity — the subscribeToActivity subscription for new entries over WebSocket.
• List records — query the records the activity feed references.
• Comments — read the comments behind CREATE_COMMENT activities.
• Workspaces overview — the rest of the workspace operations.