---
title: "List Available Team Users"
method: GET
path: "/api/v1/org/{orgId}/teams/available/users"
tags: ["Organization Teams"]
---

# List Available Team Users

`GET /api/v1/org/{orgId}/teams/available/users`

## List Available Team Users

Get the users in this StackHawk organization that are available to be assigned to a Team.

Supply the optional `teamId` query parameter to exclude the users that already belong to that Team. Omit it to list every user in the organization.

Use this endpoint to discover the user IDs to supply when creating or updating a Team.

| Parameter | Default | Description |
|:---:|:---:|:---:|
|users|[]||
|nextPageToken|""||

All users that belong to this organization can call this endpoint.


> Requires `read:team` permission.

## Path parameters

- `orgId` string, uuid, required

## Query parameters

- `teamId` string, uuid

## Response `200`

OK

- OrganizationGetAvailableTeamUsersResponse
  - `nextPageToken` string
  - `users` OrganizationTeamUser[]
    - `email` string
    - `role` string
    - `userId` string
    - `userName` string

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.dev/stackhawk/apis/stackhawk-public-api.md) · [All operations](https://skmtc.dev/stackhawk/apis/stackhawk-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stackhawk/stackhawk-public-api/revisions/8252990ac9eb/schema)