---
title: "List Deployment Users"
method: POST
path: "/api/agent/deployments/{deploymentId}/users/list"
tags: ["DeploymentService"]
---

# List Deployment Users

`POST /api/agent/deployments/{deploymentId}/users/list`

List deployment users (paginated)

## Path parameters

- `deploymentId` string, required

## Request body

- ProtosDeploymentV1ListDeploymentUsersRequest
  - `deploymentId` string
  - `options` ProtosCommonV1PaginationOptions
    - `pageToken` string
    - `pageSize` integer
    - `sortBy` string
  - `filters` ProtosDeploymentV1ListDeploymentUsersFilter
    - `query` string
    - `pruneGithub` boolean
    - `showActive` boolean
    - `filterMembers` 'MEMBER_FILTER_TYPE_ADMIN_ONLY' | 'MEMBER_FILTER_TYPE_NON_ADMIN_ONLY', enum — | value | description | |-------|---------------| | MEMBER_FILTER_TYPE_ADMIN_ONLY | | | MEMBER_FILTER_TYPE_NON_ADMIN_ONLY | |
    - `memberIds` string[]

## Response `200`

OK

- ProtosDeploymentV1ListDeploymentUsersResponse
  - `users` ProtosDeploymentV1DeploymentUser[]
    - `id` string
    - `orgRole` 'ORG_ROLE_ADMIN' | 'ORG_ROLE_MEMBER' | 'ORG_ROLE_IMPERSONATOR' | 'ORG_ROLE_READONLY', enum — | value | description | |-------|---------------| | ORG_ROLE_ADMIN | | | ORG_ROLE_MEMBER | | | ORG_ROLE_IMPERSONATOR | | | ORG_ROLE_READONLY | |
    - `authentication` string[]
    - `since` string, date-time
    - `lastUpdatedAt` string, date-time
    - `groups` ProtosDeploymentV1GroupWithRole[]
      - `group` ProtosPermissionsCommonV1Group
        - `id` string
        - `deploymentId` string
        - `name` string
        - `slug` string
        - `description` string
        - `repositoryIds` string[]
        - `users` ProtosPermissionsCommonV1GroupUser[]
          - `userId` string
          - `role` 'ROLE_ADMINISTRATOR' | 'ROLE_MANAGER' | 'ROLE_DEVELOPER' | 'ROLE_READ_ONLY' | 'ROLE_NO_ACCESS', enum — | value | description | |-------|---------------| | ROLE_ADMINISTRATOR | | | ROLE_MANAGER | | | ROLE_DEVELOPER | | | ROLE_READ_ONLY | | | ROLE_NO_ACCESS | |
        - `isDefault` boolean
        - `projectManagementType` 'PROJECT_MANAGEMENT_TYPE_UNMANAGED' | 'PROJECT_MANAGEMENT_TYPE_ALL_PROJECTS', enum — | value | description | |-------|---------------| | PROJECT_MANAGEMENT_TYPE_UNMANAGED | | | PROJECT_MANAGEMENT_TYPE_ALL_PROJECTS | |
        - `parentGroupId` string — Auth services allow for multiple parents, but the app allows only one
        - `childGroupIds` string[]
        - `repositoryCount` string
        - `userCount` string
        - `childGroupCount` string
      - `role` 'ROLE_ADMINISTRATOR' | 'ROLE_MANAGER' | 'ROLE_DEVELOPER' | 'ROLE_READ_ONLY' | 'ROLE_NO_ACCESS', enum — | value | description | |-------|---------------| | ROLE_ADMINISTRATOR | | | ROLE_MANAGER | | | ROLE_DEVELOPER | | | ROLE_READ_ONLY | | | ROLE_NO_ACCESS | |
    - `name` string
    - `login` string
    - `email` string
    - `avatarUrl` string
    - `active` boolean
  - `pageToken` string — buf:lint:ignore FIELD_SAME_CARDINALITY

---

[API](https://skmtc.dev/semgrep/apis/semgrep-web-app.md) · [All operations](https://skmtc.dev/semgrep/apis/semgrep-web-app/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/semgrep/semgrep-web-app/revisions/6483eeecd582/schema)