---
title: "GET /workspaces/{workspaceId}/serviceaccounts"
method: GET
path: "/workspaces/{workspaceId}/serviceaccounts"
---

# GET /workspaces/{workspaceId}/serviceaccounts

`GET /workspaces/{workspaceId}/serviceaccounts`

Returns a list of service accounts for a workspace.

Service accounts are only available for workspaces that are compatible with Grafana version 9 and above.

## Path parameters

- `workspaceId` string, required

## Query parameters

- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- ListWorkspaceServiceAccountsResponse
  - `nextToken` string — The token to use when requesting the next set of service accounts.
  - `serviceAccounts` ServiceAccountSummary[], required — An array of structures containing information about the service accounts.
    - `id` string, required — The unique ID of the service account.
    - `name` string, required — The name of the service account.
    - `isDisabled` string, required — Returns true if the service account is disabled. Service accounts can be disabled and enabled in the Amazon Managed Grafana console.
    - `grafanaRole` 'ADMIN' | 'EDITOR' | 'VIEWER', required — The role of the service account, which sets the permission level used when calling Grafana APIs.
  - `workspaceId` string, required — The workspace to which the service accounts are associated.

## Other responses

- `480` — ResourceNotFoundException
- `481` — ThrottlingException
- `482` — ConflictException
- `483` — ValidationException
- `484` — AccessDeniedException
- `485` — InternalServerException

---

[API](https://skmtc.net/aws/apis/grafana.md) · [All operations](https://skmtc.net/aws/apis/grafana/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/grafana/revisions/76cc5bd3d508/schema)