Apps

Rename an app, or change its theme and surfaces

Changes what the app is called, how it looks to its users (accent, radius, font, density), and which surfaces are switched on for them: data grid, interface, assistant, API, MCP, CLI.

PATCH/v1/apps/{appId}

Request

curl --request PATCH \
  --url 'https://studio.gtable.app/v1/apps/<appId>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "theme": {
    "radius": 6,
    "accent": "oklch(0.47 0.16 262)",
    "font": "geist",
    "icon": "<string>"
  },
  "surfaces": {
    "data": true,
    "interface": true,
    "assistant": true,
    "api": true,
    "mcp": true,
    "cli": true
  }
}'

import json
import requests

url = "https://studio.gtable.app/v1/apps/<appId>"
headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"name\":\"<string>\",\"theme\":{\"radius\":6,\"accent\":\"oklch(0.47 0.16 262)\",\"font\":\"geist\",\"icon\":\"<string>\"},\"surfaces\":{\"data\":true,\"interface\":true,\"assistant\":true,\"api\":true,\"mcp\":true,\"cli\":true}}")

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

const response = await fetch("https://studio.gtable.app/v1/apps/<appId>", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "name": "<string>",
    "theme": {
      "radius": 6,
      "accent": "oklch(0.47 0.16 262)",
      "font": "geist",
      "icon": "<string>"
    },
    "surfaces": {
      "data": true,
      "interface": true,
      "assistant": true,
      "api": true,
      "mcp": true,
      "cli": true
    }
  }),
});

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

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://studio.gtable.app/v1/apps/<appId>");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "PATCH");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"name\":\"<string>\",\"theme\":{\"radius\":6,\"accent\":\"oklch(0.47 0.16 262)\",\"font\":\"geist\",\"icon\":\"<string>\"},\"surfaces\":{\"data\":true,\"interface\":true,\"assistant\":true,\"api\":true,\"mcp\":true,\"cli\":true}}");
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

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

package main

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

func main() {
  req, _ := http.NewRequest("PATCH", "https://studio.gtable.app/v1/apps/<appId>", bytes.NewBuffer([]byte("{\"name\":\"<string>\",\"theme\":{\"radius\":6,\"accent\":\"oklch(0.47 0.16 262)\",\"font\":\"geist\",\"icon\":\"<string>\"},\"surfaces\":{\"data\":true,\"interface\":true,\"assistant\":true,\"api\":true,\"mcp\":true,\"cli\":true}}")))
  req.Header.Set("Authorization", "Bearer <token>")
  req.Header.Set("Content-Type", "application/json")
  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/<appId>"))
    .header("Authorization", "Bearer <token>")
    .header("Content-Type", "application/json")
    .method("PATCH", HttpRequest.BodyPublishers.ofString("{\"name\":\"<string>\",\"theme\":{\"radius\":6,\"accent\":\"oklch(0.47 0.16 262)\",\"font\":\"geist\",\"icon\":\"<string>\"},\"surfaces\":{\"data\":true,\"interface\":true,\"assistant\":true,\"api\":true,\"mcp\":true,\"cli\":true}}"))
    .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/<appId>")
request = Net::HTTP::Patch.new(uri)
request["Authorization"] = "Bearer <token>"
request["Content-Type"] = "application/json"
request.body = "{\"name\":\"<string>\",\"theme\":{\"radius\":6,\"accent\":\"oklch(0.47 0.16 262)\",\"font\":\"geist\",\"icon\":\"<string>\"},\"surfaces\":{\"data\":true,\"interface\":true,\"assistant\":true,\"api\":true,\"mcp\":true,\"cli\":true}}"

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": {
    "schemaVersion": 123.45,
    "id": "<string>",
    "name": "<string>",
    "slug": "<string>",
    "tables": [
      {
        "id": {},
        "name": {},
        "plural": {},
        "description": {},
        "primaryFieldId": {},
        "fields": {}
      }
    ],
    "views": {},
    "rules": {
      "version": 123.45,
      "groups": [
        {
          "id": {},
          "name": {},
          "description": {},
          "assistantMonthlyCredits": {},
          "interface": {}
        }
      ],
      "permissions": [
        {
          "group": {},
          "tables": {}
        }
      ]
    },
    "pages": [],
    "members": [],
    "theme": {
      "radius": 6,
      "accent": "oklch(0.47 0.16 262)",
      "font": "geist"
    },
    "surfaces": {
      "data": true,
      "interface": true,
      "assistant": true,
      "api": true,
      "mcp": true,
      "cli": true
    },
    "updatedAt": "<string>"
  }
}

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

Within a minute of switching one off: api refuses every call made with a key or a connected token, the CLI’s included (the app’s own screens, on a signed-in session, keep working); mcp refuses the app’s MCP endpoints and drops it from the suite’s MCP server; cli refuses the official command-line tool by its user agent, which with the API on stops the tool and nothing else; assistant takes the in-app assistant away; data and interface hide those tabs. Nothing is deleted by any of them.

Requires the schema:write scope. Operation apps.update. MCP tool apps_update. CLI, once published: gtable apps update.

Path parameters

Name	Type	Required	Description
`appId`	string	yes

Headers

Name	Type	Required	Description
`Idempotency-Key`	string	no	Any unique string. Sending the same key with the same request again returns the first response (marked `Idempotency-Replayed: true`) instead of running it twice. Reusing it for a different request is refused with 409. Kept for 24 hours. Up to 255 characters.

Request body

Field	Type	Required	Description
`name`	string	no	Up to 120 characters.
`theme`	object	no
`surfaces`	object	no

Response

application/json

Success

dataobjectrequired

Show child attributes

schemaVersionnumberrequired

idstringrequired

namestringrequired

slugstringrequired

tablesobject[]required

viewsRecord<string, object[]>required

rulesobjectrequired

pagesobject[]required

membersobject[]required

themeobjectrequired

surfacesobjectrequired

updatedAtstringrequired

curl --request PATCH \ --url 'https://studio.gtable.app/v1/apps/<appId>' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "<string>", "theme": { "radius": 6, "accent": "oklch(0.47 0.16 262)", "font": "geist", "icon": "<string>" }, "surfaces": { "data": true, "interface": true, "assistant": true, "api": true, "mcp": true, "cli": true } }'

{ "data": { "schemaVersion": 123.45, "id": "<string>", "name": "<string>", "slug": "<string>", "tables": [ { "id": {}, "name": {}, "plural": {}, "description": {}, "primaryFieldId": {}, "fields": {} } ], "views": {}, "rules": { "version": 123.45, "groups": [ { "id": {}, "name": {}, "description": {}, "assistantMonthlyCredits": {}, "interface": {} } ], "permissions": [ { "group": {}, "tables": {} } ] }, "pages": [], "members": [], "theme": { "radius": 6, "accent": "oklch(0.47 0.16 262)", "font": "geist" }, "surfaces": { "data": true, "interface": true, "assistant": true, "api": true, "mcp": true, "cli": true }, "updatedAt": "<string>" } }

Rename an app, or change its theme and surfaces

Path parameters

Headers

Request body

Response

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown