{"openapi":"3.1.0","info":{"title":"CloudTable API","version":"1.0.0","description":"Programmatic access to your CloudTable bases, tables, and records — over both a REST API and an MCP server. REST and MCP share one data layer, so results match. Records use the Airtable-parity shape `{ id, createdTime, fields }`.\n\n## Authentication\nCreate a key in the app: **Account menu → API keys**. Pick its scopes, copy it once, then send it on every request as **either** header:\n\n- `x-api-key: <your-key>`\n- `Authorization: Bearer <your-key>`\n\nScopes: `data:read` / `data:write` (records), `schema:read` / `schema:write` (bases, tables, fields, views), `members:read` / `members:manage`, and `mcp:tools` (use the MCP server).\n\n## MCP server\nEndpoint (Streamable HTTP): `https://api.cloudtable.insurge.io/mcp`\n\nIt exposes the same operations as this REST API as MCP tools (`list_bases`, `describe_base`, `query_records`, `create_records`, `update_records`, `delete_records`, `create_table`, `create_field`, `create_view`, `set_public_share`, …), each with an input and output schema.\n\n### Programmatic clients (Claude Desktop, Cursor, n8n, scripts) — API key\nPoint the client at `https://api.cloudtable.insurge.io/mcp` and send your API key as a bearer token: `Authorization: Bearer <your-key>` (the key needs `mcp:tools` plus the `data:*` / `schema:*` scopes for the tools you'll call). Clients that use a custom header can send `x-api-key` instead.\n\n### ChatGPT, Grok & other web clients — OAuth (no API key)\nThese connect with OAuth 2.1 — you don't paste a key. Add a **custom connector / MCP server** and give it the endpoint:\n\n`https://api.cloudtable.insurge.io/mcp`\n\nThe client then does everything automatically:\n\n1. **Discovers** the authorization server via `/.well-known/oauth-protected-resource` → `/.well-known/oauth-authorization-server`.\n2. **Registers itself** with Dynamic Client Registration (RFC 7591) — no manual client setup.\n3. Opens CloudTable's **sign-in + consent** screen (PKCE S256).\n4. Receives an access token and calls the tools.\n\nYou'll be prompted to sign in to CloudTable and approve the requested scopes. That's it.\n\n## n8n\nUse the **HTTP Request** node with **Header Auth** — header `x-api-key`, base URL `https://api.cloudtable.insurge.io/api/v1`."},"servers":[{"url":"https://api.cloudtable.insurge.io","description":"CloudTable"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{},"parameters":{}},"paths":{"/api/v1/me":{"get":{"summary":"Who am I","tags":["Meta"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Caller identity + accessible resources","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"orgs":{"type":"array","items":{"type":"object","properties":{"orgId":{"type":"string"},"role":{"type":"string"}},"required":["orgId","role"]}},"bases":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"workspaceId":{"type":"string","nullable":true},"orgId":{"type":"string","nullable":true}},"required":["id","name","workspaceId","orgId"]}}},"required":["id","kind","scopes","orgs","bases"]}}}},"401":{"description":"Unauthorized"}}}},"/api/v1/bases":{"get":{"summary":"List bases","tags":["Bases"],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Accessible bases","content":{"application/json":{"schema":{"type":"object","properties":{"bases":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"workspaceId":{"type":"string","nullable":true},"orgId":{"type":"string","nullable":true}},"required":["id","name","workspaceId","orgId"]}}},"required":["bases"]}}}},"401":{"description":"Unauthorized"}}},"post":{"summary":"Create base","description":"Creates a base inside an organization. Pass a workspaceId, or an orgId (its default workspace is used), or neither if you belong to exactly one org. A base is never created without an org.","tags":["Bases"],"security":[{"ApiKeyAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"workspaceId":{"type":"string"},"orgId":{"type":"string"}},"required":["name"]}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id"]}}}},"400":{"description":"Ambiguous or unauthorized org/workspace"},"401":{"description":"Unauthorized"}}}},"/api/v1/bases/{baseId}":{"get":{"summary":"Describe base","description":"The base's tables, each with its fields and views — everything needed to read/write it, in one call.","tags":["Bases"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"baseId","in":"path"}],"responses":{"200":{"description":"Base schema","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"tables":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"isPrimary":{"type":"boolean"},"order":{"type":"number"},"options":{"type":"array","items":{"type":"string"}},"linkedTableId":{"type":"string"}},"required":["id","name","type","isPrimary","order"]}},"views":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"config":{"type":"object","additionalProperties":{"nullable":true}}},"required":["id","name","type","config"]}}},"required":["id","name","fields","views"]}}},"required":["id","name","tables"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"patch":{"summary":"Update base (name/icon)","tags":["Bases"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"baseId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"icon":{"type":"object","properties":{"kind":{"type":"string","enum":["emoji","lucide","image"]},"value":{"type":"string"},"color":{"type":"string"}},"required":["kind","value"]}}}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"delete":{"summary":"Delete base","tags":["Bases"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"baseId","in":"path"}],"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"string"}},"required":["deleted"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/api/v1/bases/{baseId}/tables":{"get":{"summary":"List tables","tags":["Tables"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"baseId","in":"path"}],"responses":{"200":{"description":"Tables","content":{"application/json":{"schema":{"type":"object","properties":{"tables":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}}},"required":["tables"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"post":{"summary":"Create table","tags":["Tables"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"baseId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/api/v1/tables/{tableId}/fields":{"get":{"summary":"List fields","tags":["Tables"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"tableId","in":"path"}],"responses":{"200":{"description":"Fields","content":{"application/json":{"schema":{"type":"object","properties":{"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"isPrimary":{"type":"boolean"},"order":{"type":"number"},"options":{"type":"array","items":{"type":"string"}},"linkedTableId":{"type":"string"}},"required":["id","name","type","isPrimary","order"]}}},"required":["fields"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"post":{"summary":"Add field","description":"Create a column. type is one of the field types (text, number, single_select, …); link/button not supported via API.","tags":["Tables"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"tableId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"},"config":{"type":"object","additionalProperties":{"nullable":true}},"position":{"type":"number"}},"required":["name","type"]}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"required":["id","name","type"]}}}},"400":{"description":"Bad input"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/api/v1/tables/{tableId}/views":{"get":{"summary":"List views","tags":["Tables"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"tableId","in":"path"}],"responses":{"200":{"description":"Views","content":{"application/json":{"schema":{"type":"object","properties":{"views":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"config":{"type":"object","additionalProperties":{"nullable":true}}},"required":["id","name","type","config"]}}},"required":["views"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"post":{"summary":"Create view","tags":["Tables"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"tableId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"}},"required":["type"]}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}},"required":["id","name","type"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/api/v1/tables/{tableId}/records":{"get":{"summary":"List records","description":"Records in Airtable-parity shape. Optional: ?view=<viewId>, ?search=<text>, ?limit (max 100), ?offset, and ?filters / ?sorts as URL-encoded JSON ([{fieldId,op,value}] / [{fieldId,dir}]).","tags":["Records"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"tableId","in":"path"},{"schema":{"type":"string"},"required":false,"name":"view","in":"query"},{"schema":{"type":"string"},"required":false,"name":"search","in":"query"},{"schema":{"type":"string"},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"offset","in":"query"},{"schema":{"type":"string"},"required":false,"name":"filters","in":"query"},{"schema":{"type":"string"},"required":false,"name":"sorts","in":"query"}],"responses":{"200":{"description":"Records page","content":{"application/json":{"schema":{"type":"object","properties":{"records":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"createdTime":{"type":"string"},"fields":{"type":"object","additionalProperties":{"nullable":true}}},"required":["id","fields"]}},"total":{"type":"number"},"offset":{"type":"number"},"limit":{"type":"number"},"hasMore":{"type":"boolean"}},"required":["records","total","offset","limit","hasMore"]}}}},"400":{"description":"Bad query"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"post":{"summary":"Create records","description":"Body: { fields } for one, or { records: [{ fields }] } for many. Pass upsertOn: [\"Field Name\"] to update matching rows instead of inserting. Fields are keyed by name; selects accept the option name, links accept record ids.","tags":["Records"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"tableId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"fields":{"type":"object","additionalProperties":{"nullable":true}},"records":{"type":"array","items":{"type":"object","properties":{"fields":{"type":"object","additionalProperties":{"nullable":true}}},"required":["fields"]}},"upsertOn":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Created/upserted records","content":{"application/json":{"schema":{"type":"object","properties":{"records":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"createdTime":{"type":"string"},"fields":{"type":"object","additionalProperties":{"nullable":true}}},"required":["id","fields"]}}},"required":["records"]}}}},"400":{"description":"Bad input"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"patch":{"summary":"Update records (bulk)","description":"Body: { records: [{ id, fields }] }.","tags":["Records"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"tableId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"records":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fields":{"type":"object","additionalProperties":{"nullable":true}}},"required":["id","fields"]}}},"required":["records"]}}}},"responses":{"200":{"description":"Updated records","content":{"application/json":{"schema":{"type":"object","properties":{"records":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"createdTime":{"type":"string"},"fields":{"type":"object","additionalProperties":{"nullable":true}}},"required":["id","fields"]}}},"required":["records"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"delete":{"summary":"Delete records (bulk)","tags":["Records"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"tableId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"}}},"required":["ids"]}}}},"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"array","items":{"type":"string"}}},"required":["deleted"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/api/v1/tables/{tableId}/records/search":{"get":{"summary":"Search records","description":"Full-text substring search across all fields.","tags":["Records"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"tableId","in":"path"},{"schema":{"type":"string"},"required":true,"name":"q","in":"query"},{"schema":{"type":"string"},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Matching records","content":{"application/json":{"schema":{"type":"object","properties":{"records":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"createdTime":{"type":"string"},"fields":{"type":"object","additionalProperties":{"nullable":true}}},"required":["id","fields"]}},"total":{"type":"number"},"offset":{"type":"number"},"limit":{"type":"number"},"hasMore":{"type":"boolean"}},"required":["records","total","offset","limit","hasMore"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/api/v1/records/{recordId}":{"get":{"summary":"Get record","tags":["Records"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"recordId","in":"path"}],"responses":{"200":{"description":"Record","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"createdTime":{"type":"string"},"fields":{"type":"object","additionalProperties":{"nullable":true}}},"required":["id","fields"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"patch":{"summary":"Update record","description":"Merge the given fields into a record. An empty string clears a field.","tags":["Records"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"recordId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"fields":{"type":"object","additionalProperties":{"nullable":true}}},"required":["fields"]}}}},"responses":{"200":{"description":"Updated record","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"createdTime":{"type":"string"},"fields":{"type":"object","additionalProperties":{"nullable":true}}},"required":["id","fields"]}}}},"400":{"description":"Bad input"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"delete":{"summary":"Delete record","tags":["Records"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"recordId","in":"path"}],"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"array","items":{"type":"string"}}},"required":["deleted"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/api/v1/orgs/{orgId}/workspaces":{"get":{"summary":"List workspaces","tags":["Workspaces"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"orgId","in":"path"}],"responses":{"200":{"description":"Workspaces","content":{"application/json":{"schema":{"type":"object","properties":{"workspaces":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string","nullable":true}},"required":["id","name","color"]}}},"required":["workspaces"]}}}},"401":{"description":"Unauthorized"}}}},"/api/v1/workspaces":{"post":{"summary":"Create workspace","tags":["Workspaces"],"security":[{"ApiKeyAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"orgId":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"}},"required":["orgId","name"]}}}},"responses":{"200":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id"]}}}},"401":{"description":"Unauthorized"}}}},"/api/v1/workspaces/{workspaceId}":{"patch":{"summary":"Update workspace","tags":["Workspaces"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"workspaceId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"icon":{"type":"object","properties":{"kind":{"type":"string","enum":["emoji","lucide","image"]},"value":{"type":"string"},"color":{"type":"string"}},"required":["kind","value"]}}}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"delete":{"summary":"Delete workspace","tags":["Workspaces"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"workspaceId","in":"path"}],"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"string"}},"required":["deleted"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/api/v1/tables/{tableId}":{"patch":{"summary":"Update table (name/icon)","tags":["Tables"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"tableId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"icon":{"type":"object","properties":{"kind":{"type":"string","enum":["emoji","lucide","image"]},"value":{"type":"string"},"color":{"type":"string"}},"required":["kind","value"]}}}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"delete":{"summary":"Delete table","tags":["Tables"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"tableId","in":"path"}],"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"string"}},"required":["deleted"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/api/v1/fields/{fieldId}":{"patch":{"summary":"Update field","tags":["Tables"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"fieldId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"config":{"type":"object","additionalProperties":{"nullable":true}},"hidden":{"type":"boolean"},"width":{"type":"number"}}}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"delete":{"summary":"Delete field","tags":["Tables"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"fieldId","in":"path"}],"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"string"}},"required":["deleted"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/api/v1/views/{viewId}":{"patch":{"summary":"Update view (name/config)","tags":["Tables"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"viewId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"config":{"type":"object","additionalProperties":{"nullable":true}},"unset":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"delete":{"summary":"Delete view","tags":["Tables"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"viewId","in":"path"}],"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"string"}},"required":["deleted"]}}}},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/api/v1/bases/{baseId}/share":{"get":{"summary":"Get public share","tags":["Sharing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"baseId","in":"path"}],"responses":{"200":{"description":"Share state","content":{"application/json":{"schema":{"type":"object","properties":{"publicShareId":{"type":"string","nullable":true}},"required":["publicShareId"]}}}},"401":{"description":"Unauthorized"}}},"put":{"summary":"Enable/regenerate public share","tags":["Sharing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"baseId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"regenerate":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Share token","content":{"application/json":{"schema":{"type":"object","properties":{"publicShareId":{"type":"string","nullable":true}},"required":["publicShareId"]}}}},"401":{"description":"Unauthorized"}}},"delete":{"summary":"Disable public share","tags":["Sharing"],"security":[{"ApiKeyAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"baseId","in":"path"}],"responses":{"200":{"description":"Disabled","content":{"application/json":{"schema":{"type":"object","properties":{"publicShareId":{"type":"string","nullable":true}},"required":["publicShareId"]}}}},"401":{"description":"Unauthorized"}}}}}}