---
title: "Changes to List grants"
method: GET
path: "/v1/workspaces/{workspaceId}/grants"
---

# Changes to List grants

`GET /v1/workspaces/{workspaceId}/grants`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 22 revisions.

- **2026-10-17** `a43d748cfdda`: 1 warning
- **2026-10-16** `924c2aeaed12`: 4 info

## Changes

- **2026-10-17** `a43d748cfdda`: 1 warning
  - added the new `guest` enum value to the `grants/items/subject_type` response property for the response status `200`
- **2026-10-16** `924c2aeaed12`: 4 info
  - added the optional property `grants/items/created_at` to the response with the `200` status
  - added the optional property `grants/items/expires_at` to the response with the `200` status
  - added the optional property `grants/items/granted_by` to the response with the `200` status
  - added the optional property `grants/items/subject_label` to the response with the `200` status

---

[Operation](https://skmtc.dev/shareout/apis/shareout-rest-api/docs/v1/workspaces/:workspaceId/grants/get.md) - [API](https://skmtc.dev/shareout/apis/shareout-rest-api.md) - [Page](https://skmtc.dev/shareout/apis/shareout-rest-api/changes/v1/workspaces/:workspaceId/grants/get)