Suites

Create a suite

A new directory and a new login page, empty.

POST/v1/organizations/{organizationId}/suites

Request

curl --request POST \
  --url 'https://studio.gtable.app/v1/organizations/<organizationId>/suites' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>"
}'

import json
import requests

url = "https://studio.gtable.app/v1/organizations/<organizationId>/suites"
headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"name\":\"<string>\"}")

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

const response = await fetch("https://studio.gtable.app/v1/organizations/<organizationId>/suites", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "name": "<string>"
  }),
});

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

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://studio.gtable.app/v1/organizations/<organizationId>/suites");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"name\":\"<string>\"}");
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("POST", "https://studio.gtable.app/v1/organizations/<organizationId>/suites", bytes.NewBuffer([]byte("{\"name\":\"<string>\"}")))
  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/organizations/<organizationId>/suites"))
    .header("Authorization", "Bearer <token>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"name\":\"<string>\"}"))
    .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/organizations/<organizationId>/suites")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer <token>"
request["Content-Type"] = "application/json"
request.body = "{\"name\":\"<string>\"}"

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>",
    "organizationId": "<string>",
    "name": "<string>",
    "slug": "<string>",
    "authPassword": true,
    "authGoogle": true,
    "allowSelfSignup": true,
    "accent": "<string>",
    "logoUrl": "<string>",
    "createdAt": "<string>",
    "assistantMonthlyCredits": 123,
    "apps": 123,
    "users": 123,
    "assistantCreditsUsed": 123.45,
    "assistantCreditsLimit": null,
    "assistantPresets": [
      {
        "label": "<string>",
        "model": "<string>",
        "reasoning": "none"
      }
    ],
    "assistantPresetsEditable": true
  }
}

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

Nobody is in it, and creating it grants you no access to any app inside it. slug is the subdomain it answers on, given one that is taken, the call is refused rather than suffixed, because an address is not a name. Omit it and one is derived from the name.

Requires the schema:write scope. Operation suites.create. MCP tool suites_create. CLI, once published: gtable suites create.

Path parameters

Name	Type	Required	Description
`organizationId`	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	yes	Up to 120 characters.
`slug`	string	no	Up to 40 characters.

Response

application/json

Success

dataobjectrequired

Show child attributes

idstringrequired

organizationIdstringrequired

namestringrequired

slugstringrequired

authPasswordbooleanrequired

authGooglebooleanrequired

allowSelfSignupbooleanrequired

accentstring | nullrequired

logoUrlstring | nullrequired

createdAtstringrequired

assistantMonthlyCreditsinteger | nullrequired

appsintegerrequired

usersintegerrequired

assistantCreditsUsednumber

assistantCreditsLimitnumbernull

assistantPresetsobject[]required

assistantPresetsEditableboolean

curl --request POST \ --url 'https://studio.gtable.app/v1/organizations/<organizationId>/suites' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "<string>" }'

{ "data": { "id": "<string>", "organizationId": "<string>", "name": "<string>", "slug": "<string>", "authPassword": true, "authGoogle": true, "allowSelfSignup": true, "accent": "<string>", "logoUrl": "<string>", "createdAt": "<string>", "assistantMonthlyCredits": 123, "apps": 123, "users": 123, "assistantCreditsUsed": 123.45, "assistantCreditsLimit": null, "assistantPresets": [ { "label": "<string>", "model": "<string>", "reasoning": "none" } ], "assistantPresetsEditable": true } }

Create a suite

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