---
title: "List activity groups for a layer"
method: GET
path: "/clouddiagrams/v1/activity"
tags: ["Cloud Diagrams"]
---

# List activity groups for a layer

`GET /clouddiagrams/v1/activity`

Returns snapshot activity groups for the specified diagram layer,
ordered by timestamp descending. Each group contains a snapshot reference
and the individual activity records that belong to it.

## Query parameters

- `ss_id` string, required
- `limit` integer
- `offset` integer
- `tags` string[]

## Response `200`

OK - Activity groups returned.

- CloudDiagramSnapshotActivityGroup[]
  - `_id` string, required — Activity group ID.
  - `statussheet` string, required — Layer ID this group belongs to.
  - `timestamp` string, date-time, required — Timestamp of the activity group.
  - `tags` string[] — Tags associated with the group.
  - `snapshot` string, required — ID of the associated snapshot (equal to the group ID).
  - `items` CloudDiagramActivityItem[] — Individual activity records within this group.
    - `_id` string, required — Activity record ID.
    - `group` string, required — ID of the activity group this record belongs to.
    - `activity` 'NODE_CREATE' | 'NODE_UPDATE' | 'NODE_DELETE' | 'LINK_CREATE' | 'LINK_UPDATE' | 'LINK_DELETE' | 'GROUP_CREATE' | 'GROUP_UPDATE' | 'GROUP_DELETE' | 'ATTACHMENT_CREATE' | 'ATTACHMENT_UPDATE' | 'ATTACHMENT_DELETE', required — Activity type.
    - `metadata` object — Activity-specific payload (structure varies by activity type).
    - `timestamp` string, date-time, required — Timestamp of the activity.
    - `service_type` string — Cloud service type the activity applies to.
    - `group_type` string — Activity group sub-type.
    - `tags` string[] — Tags associated with the activity.

## Other responses

- `400` — Bad Request - The server cannot process the request, often due to a malformed request.
- `401` — Unauthorized - Invalid API key.
- `403` — Forbidden - The client is not authorized to perform the request.

---

[API](https://skmtc.dev/doit/apis/doit-cloud-intelligence.md) · [All operations](https://skmtc.dev/doit/apis/doit-cloud-intelligence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/doit/doit-cloud-intelligence/revisions/9416402fc119/schema)