Add several related tables at once
Add several related tables at once
POST/v1/apps/{appId}/tables/batch
Create up to 20 tables in one change, links between them included: a link field’s config.tableId may be the NAME (or plural) of a table in this same call, or of one that already exists, so no order and no follow-up fields.create is needed. Prefer it to several tables.create whenever a request needs more than one table (a CRM, an inventory). Each field is { name, type, config? }; fields.types lists the settings each type takes. Omit every id to receive minted tbl_… and fld_… ids, in the order sent. All or nothing: one refused table creates none.
Requires the schema:write scope. Operation tables.createMany. MCP tool tables_createMany. CLI: grid82 tables create-many (npx @grid82/cli).
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 |
|---|---|---|---|
tables | object[] | yes | 1 to 20 items. |
Response
Success
dataobject[]requiredRefused
errorobjectrequired