List your apps

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

GET/v1/apps

Request

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

import json
import requests

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

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

const response = await fetch("https://studio.grid82.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.grid82.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.grid82.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.grid82.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.grid82.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,
      "icon": 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: grid82 apps list (npx grid82).

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

data.idstringrequired

data.namestringrequired

data.slugstringrequired

data.suiteIdstringrequired

data.updatedAtstringrequired

data.statusstringrequired

data.hostnamestringnullrequired

data.urlstringnullrequired

data.iconstringnull

metaobjectrequired

Show child attributes

meta.nextCursorstringnullrequired

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

meta.hasMorebooleanrequired

meta.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, "icon": 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