---
title: "GET /api/v1/resources/{ResourceId}/permissions"
method: GET
path: "/api/v1/resources/{ResourceId}/permissions"
---

# GET /api/v1/resources/{ResourceId}/permissions

`GET /api/v1/resources/{ResourceId}/permissions`

Describes the permissions of a specified resource.

## Path parameters

- `ResourceId` string, required

## Query parameters

- `principalId` string
- `limit` integer
- `marker` string
- `Limit` string
- `Marker` string

## Headers

- `Authentication` string, password

## Response `200`

Success

- DescribeResourcePermissionsResponse
  - `Principals` Principal[] — The principals.
    - `Id` string — The ID of the resource.
    - `Type` 'USER' | 'GROUP' | 'INVITE' | 'ANONYMOUS' | 'ORGANIZATION' — The type of resource.
    - `Roles` PermissionInfo[] — The permission information for the resource.
      - `Role` 'VIEWER' | 'CONTRIBUTOR' | 'OWNER' | 'COOWNER' — The role of the user.
      - `Type` 'DIRECT' | 'INHERITED' — The type of permissions.
  - `Marker` string — The marker to use when requesting the next set of results. If there are no additional results, the string is empty.

## Other responses

- `480` — InvalidArgumentException
- `481` — UnauthorizedOperationException
- `482` — UnauthorizedResourceAccessException
- `483` — FailedDependencyException
- `484` — ServiceUnavailableException

---

[API](https://skmtc.net/aws/apis/workdocs.md) · [All operations](https://skmtc.net/aws/apis/workdocs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/workdocs/versions/8a533af4e1ef/schema)