---
title: "A suite's directory"
description: "Everyone who can sign in at this suite's apps, and which apps they are in."
canonical: "https://gtable.app/docs/builder-api/users/list"
updated: "2026-10-05"
---

# A suite's directory

`GET https://studio.gtable.app/v1/users`

Everyone who can sign in at this suite's apps, and which apps they are in.

One user holds one account per suite and can be a member of many of its apps, so start here rather than inviting the same colleague again for each app. `apps` carries the apps themselves with the groups the user holds in each, because "how many" is the one fact about a user nobody can act on.

Requires the `members:read` scope. Operation `users.list`. MCP tool `users_list`. CLI, once published: `gtable users list`.

## Query parameters

| Name      | Type    | Required | Description           |
| --------- | ------- | -------- | --------------------- |
| `limit`   | integer | no       | Default `50`.         |
| `cursor`  | string  | no       | Up to 512 characters. |
| `suiteId` | string  | yes      | Up to 64 characters.  |
| `search`  | string  | no       | Up to 200 characters. |