Get all workspace updates

GET

/workspaces/:workspaceId/updates

GET

/workspaces/:workspaceId/updates

$ curl https://api.postman.com/workspaces/1f0df51a-8658-4ee8-a2a1-d2567dfa09a9/updates \
>      -H "x-api-key: <apiKey>"

1 {
2   "data": [
3     {
4       "id": 1,
5       "topic": "API v1.0 released",
6       "description": "We've released the first version of our newest API!",
7       "workspaceId": "1f0df51a-8658-4ee8-a2a1-d2567dfa09a9",
8       "createdBy": {
9         "id": 12345678,
10         "name": "Taylor Lee",
11         "username": "taylor-lee"
12       },
13       "updatedBy": 12345678,
14       "createdAt": "2026-04-10T09:36:21.000Z",
15       "updatedAt": "2026-04-10T11:58:43.000Z",
16       "category": "announcement",
17       "isPinned": true,
18       "relatedResources": [
19         {
20           "resource": "collection",
21           "resourceId": "12345678-12ece9e1-2abf-4edc-8e34-de66e74114d2"
22         }
23       ]
24     }
25   ],
26   "meta": {
27     "nextCursor": "e3BhZ2VJZDoyfQ=="
28   }
29 }

Gets a list of workspace updates for the given workspace.

Authentication

x-api-keystring

API Key authentication via header

Path parameters

workspaceIdstringRequired

The workspace's ID.

Query parameters

cursorstringOptional

The pointer to the first record of the set of paginated results. To view the next response, use the nextCursor value for this parameter.

categorystringOptional

A comma-separated list of categories to filter the results by. Accepts improvement, bug_fix, new_feature, breaking_change, announcement.

Response

Successful Response

datalist of objects

A list of workspace updates.

metaobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error