---
title: "List grants"
method: GET
path: "/v1/workspaces/{workspaceId}/grants"
tags: ["External sharing"]
---

# List grants

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

## Query parameters

- `subject_id` string
- `resource_type` 'folder' | 'artifact' | 'file'
- `resource_id` string

## Response `200`

Grants

- object
  - `grants` Grant[]
    - `id` string
    - `subject_type` 'sharee' | 'external_user'
    - `subject_id` string
    - `resource_type` 'folder' | 'artifact' | 'file'
    - `resource_id` string
    - `capability` 'view' | 'comment' | 'create' | 'edit'

---

[API](https://skmtc.net/shareout/apis/shareout-rest-api.md) · [All operations](https://skmtc.net/shareout/apis/shareout-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shareout/shareout-rest-api/versions/804359ead65a/schema)