tables
mcp-searchable-tool

Update a table

Partially update a table's name or description (omitted fields are left untouched). Cosmetic only: no recompute run is requested.

patch/tables/{table_id}/

Request

  • Base URL: https://api.getoneprofile.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.getoneprofile.ai/tables/{table_id}/
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

table_idstring uuid required

Request body

Response

Successful Response

ai_madeboolean

Whether the AI Assistant created this table through a granted action. The owner is still the person who approved it.

archived_atstring date-time nullable

When somebody archived it; null for a table on the list. An archived table is left out of All, its folder, Favorites and Recent, and still found by search and opened as before.

auto_runboolean required

Whether data changes request recompute runs by themselves. Column-definition changes always recompute.

created_atstring date-time required
deleted_atstring date-time nullable

When the table was moved to trash; null for a live table.

descriptionstring nullable required
folder_idstring uuid nullable

The folder it sits in; null for the top level.

former_tagsstring[]

The tags it carried when folders replaced tags, when it carried more than one and so waits for somebody to file it. Empty once it is filed.

idstring uuid required
is_favoriteboolean

Whether the CALLING USER starred this table. Per-user, so a teammate may see a different value. Always false for API-key callers, which have no user to have preferences.

keep_existing_resultsboolean required

Whether a manual run-all only fills the errored, empty and stale cells rather than recomputing every cell in scope.

last_viewed_atstring date-time nullable

When the calling user last opened this table; null means never.

namestring required
owner_display_namestring nullable

The owner's name, resolved for display. Null when there is no owner or the account has no name to show.

owner_user_idstring nullable

Who created the table. Null for tables older than this field and for anything a background job created. NOT an access control: every member of the organisation can open and edit every table.

row_countinteger required

Exact row count, maintained atomically by row mutations.

shared_as_templateboolean

Whether this table's shape is readable by anyone with the link, with no sign-in. Never its rows.

updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.