Apps

List your apps

Every app you build, newest first, across every organisation and suite.

GET/v1/apps

Request

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

import json
import requests

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

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

const response = await fetch("https://studio.gtable.app/v1/apps", {
  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/apps");
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/apps", 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/apps"))
    .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/apps")
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": [
    {
      "id": "<string>",
      "name": "<string>",
      "slug": "<string>",
      "suiteId": "<string>",
      "updatedAt": "<string>",
      "status": "<string>",
      "hostname": null,
      "url": null
    }
  ],
  "meta": {
    "nextCursor": null,
    "hasMore": true,
    "fields": {}
  }
}

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

Start here when you do not know an app id: every other builder tool needs one.

Requires the account:read scope. Operation apps.list. MCP tool apps_list. CLI, once published: gtable apps list.

Query parameters

Name	Type	Required	Description
`limit`	integer	no	Default `50`.
`cursor`	string	no	Up to 512 characters.
`suiteId`	string	no	Up to 64 characters.

Response

application/json

Success

dataobject[]required

Show child attributes

idstringrequired

namestringrequired

slugstringrequired

suiteIdstringrequired

updatedAtstringrequired

statusstringrequired

hostnamestringnullrequired

urlstringnullrequired

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": [ { "id": "<string>", "name": "<string>", "slug": "<string>", "suiteId": "<string>", "updatedAt": "<string>", "status": "<string>", "hostname": null, "url": null } ], "meta": { "nextCursor": null, "hasMore": true, "fields": {} } }

List your apps

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