A suite's directory

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

GET/v1/users

Request

curl --request GET \
  --url 'https://studio.gtable.app/v1/users?suiteId=<suiteId>' \
  --header 'Authorization: Bearer <token>'

import json
import requests

url = "https://studio.gtable.app/v1/users?suiteId=<suiteId>"
headers = {
  "Authorization": "Bearer <token>"
}

response = requests.request("GET", url, headers=headers)
print(response.json())

const response = await fetch("https://studio.gtable.app/v1/users?suiteId=<suiteId>", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <token>"
  },
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://studio.gtable.app/v1/users?suiteId=<suiteId>");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer <token>",
]);
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://studio.gtable.app/v1/users?suiteId=<suiteId>", nil)
  req.Header.Set("Authorization", "Bearer <token>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://studio.gtable.app/v1/users?suiteId=<suiteId>"))
    .header("Authorization", "Bearer <token>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://studio.gtable.app/v1/users?suiteId=<suiteId>")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer <token>"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": [
    {
      "userId": "<string>",
      "email": "<string>",
      "name": null,
      "status": "<string>",
      "kind": "builder",
      "apps": [
        {
          "id": "<string>",
          "name": "<string>",
          "groups": [
            {}
          ]
        }
      ]
    }
  ],
  "meta": {
    "nextCursor": null,
    "hasMore": true,
    "fields": {}
  }
}

{
  "error": {
    "code": "not_found",
    "message": "<string>",
    "details": {}
  }
}

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.

Response

application/json

Success

dataobject[]required

Show child attributes

userIdstringrequired

emailstringrequired

namestringnullrequired

statusstringrequired

kindstringrequired

appsobject[]required

metaobjectrequired

Show child attributes

nextCursorstringnullrequired

Pass as cursor for the next page. Null on the last one.

hasMorebooleanrequired

fieldsRecord<string, string>

Field id to field name, for the table the records came from.

{ "data": [ { "userId": "<string>", "email": "<string>", "name": null, "status": "<string>", "kind": "builder", "apps": [ { "id": "<string>", "name": "<string>", "groups": [ {} ] } ] } ], "meta": { "nextCursor": null, "hasMore": true, "fields": {} } }

A suite's directory

Query parameters

Response

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown