Update table

patchhttps://api.integrable.cloud/api/data-tables/{table_id}

Authentication: Bearer token
Retries: Idempotency-Key
Body: application/json
Version: 2026-09-03

Path parameters#

table_idstring (uuid)required

Headers#

Idempotency-Keystring
A unique key of your choosing, so this request can be retried safely. The first request with a given key executes; every replay returns that first response unchanged, with Idempotent-Replay: true set.
Generate one key per action, not per session - reusing a key with a different body is refused with 422 rather than silently replaying the wrong answer. Keys are remembered for 24 hours. A request that failed releases its key, so a retry after fixing the payload runs normally.
Up to 255 characters

Request body#

application/json · required

DataTableUpdate

columnsarray of ColumnSpec | null
4 fieldsColumnSpec
- keystringrequired
  Up to 120 characters
- labelstring | null
  Up to 120 characters
- rolestring
  Default: hidden·Up to 16 characters
- typestring
  Default: string·Up to 24 characters
descriptionstring | null
Up to 2000 characters
is_enabledboolean | null
namestring | null
Up to 120 characters
panels_enabledboolean | null
status_before_verifyboolean | null

Responses#

200OKapplication/json
DataTableResponse
- agent_idstring (uuid) | nullrequired
- columnsarray of objectrequired
- descriptionstringrequired
- idstring (uuid)required
- is_enabledbooleanrequired
- is_usablebooleanrequired
- last_errorstring | nullrequired
- last_synced_atany | nullrequired
- max_rowsintegerrequired
- namestringrequired
- panels_enabledbooleanrequired
- row_countintegerrequired
- status_before_verifybooleanrequired
- tool_namestringrequired
5 response headers
RateLimit-Limit
Requests permitted in the current window.
RateLimit-Remaining
Requests left in the current window. Back off before it reaches 0.
RateLimit-Reset
Seconds until the current window resets.
X-API-Version
The dated version of the API contract that served this response, e.g. 2026-09-03. Pin against it; it changes only when a response shape changes incompatibly.
X-Request-ID
Quote this in a support request to identify the call.
422Validation error
The shared error envelope, served as application/problem+json with error.code set to validation_error. Its details name each field that failed and why.

Request · curl

curl -X PATCH "https://api.integrable.cloud/api/data-tables/$TABLE_ID" \
  -H "Authorization: Bearer $INTEGRABLE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "columns": [
      {
        "key": "string"
      }
    ]
  }'

Set INTEGRABLE_API_KEY and the path variables first. The TypeScript and Python SDKs take the same fields.

Response · 200 OK · application/json

{
  "agent_id": "01a0652b-3713-7ea1-a6c9-2e895389ec34",
  "columns": [
    {}
  ],
  "description": "string",
  "id": "01a0652b-3713-7ea1-a6c9-2e895389ec34",
  "is_enabled": true,
  "is_usable": true,
  "last_error": "string",
  "last_synced_at": null,
  "max_rows": 0,
  "name": "string",
  "panels_enabled": true,
  "row_count": 20,
  "status_before_verify": true,
  "tool_name": "string"
}

Generated from the schema: the shape is exact, the values are placeholders.

Errors#

Failures use one envelope on every endpoint, described in Retries, versioning and limits. The codes you are most likely to meet here:

validation_error · 422 — The payload was well-formed JSON but failed schema validation.
unauthenticated · 401 — The request carried no API key, or one the API could not verify.
forbidden · 403 — The key is valid, but it is not allowed to do this — either the scope is missing or the resource belongs to another workspace.
idempotency_key_reused · 422 — This `Idempotency-Key` was used before, for a request with a different body.
rate_limited · 429 — Too many requests in the current window. The limit is per workspace, and some endpoints add a per-agent limit on top.

More Data tables endpoints#

Something unclear or missing? Tell us and we’ll fix it.