Delete a table and its rows

Drop the table and all its rows; remove links to it from other tables and references to it in rules.

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

Request

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

import json
import requests

url = "https://studio.grid82.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.grid82.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.grid82.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.grid82.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.grid82.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.grid82.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": {}
  }
}

Rows, links, and grants go to the app’s trash for 30 days; trash.restore can restore the table with the same IDs. Send its current name as confirm. Returns 409 with readers in details.impact until you send acknowledge=true.

Requires the schema:write scope. Operation tables.delete. MCP tool tables_delete. CLI: grid82 tables delete (npx grid82).

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

data.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