---
title: "GET /workspaces/{workspaceId}/grants"
method: GET
path: "/workspaces/{workspaceId}/grants"
tags: ["Workspaces"]
---

# GET /workspaces/{workspaceId}/grants

`GET /workspaces/{workspaceId}/grants`

## Response `200`

Grants

- WorkspaceGrantListResponse
  - `data` object, required
    - `items` WorkspaceGrant[], required
      - `createdAt` string, date-time, required
      - `email` string
      - `name` string
      - `role` 'viewer' | 'editor' | 'admin' | 'auditor', required
      - `updatedAt` string, date-time, required
      - `userId` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — WORKSPACE_NOT_BACKFILLED: the default is still virtual (no row, no grants)

## Changes

- **2026-10-02** `766c2a40e369` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/greentally/apis/esgai-api/changes/workspaces/:workspaceId/grants/get.md)

---

[API](https://skmtc.dev/greentally/apis/esgai-api.md) · [All operations](https://skmtc.dev/greentally/apis/esgai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/greentally/apis/esgai-api/revisions/4189686230ca?raw)