Tables

Delete a table and its rows

Drops the table and every row in it, with the link fields on other tables that pointed at it, and removes it from every rule that named it.

DELETE/v1/apps/{appId}/tables/{tableId}

Request

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

import json
import requests

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

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

const response = await fetch("https://studio.gtable.app/v1/apps/<appId>/tables/<tableId>", {
  method: "DELETE",
  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/<appId>/tables/<tableId>");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "DELETE");
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("DELETE", "https://studio.gtable.app/v1/apps/<appId>/tables/<tableId>", 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/<appId>/tables/<tableId>"))
    .header("Authorization", "Bearer <token>")
    .method("DELETE", 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/<appId>/tables/<tableId>")
request = Net::HTTP::Delete.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>"
  }
}

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

Its rows, its links and its grants go to the app’s trash for thirty days first, so trash.restore can put the whole table back with the same ids. Refused with the list of what reads it (409, details.impact) until you send acknowledge=true. Send the table’s current name as confirm.

Requires the schema:write scope. Operation tables.delete. MCP tool tables_delete. CLI, once published: gtable tables delete.

Path parameters

Name	Type	Required	Description
`appId`	string	yes
`tableId`	string	yes

Query parameters

Name	Type	Required	Description
`confirm`	string	no	Up to 200 characters.
`acknowledge`	boolean	no

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.

Response

application/json

Success

dataobjectrequired

Show child attributes

idstringrequired

Delete a table and its rows

Path parameters

Query parameters

Headers

Response

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown