tables
mcp-always-include

Create a table

Create a table with its starter canvas: one manual text column (New column) and a screenful of empty rows. One request transaction, atomic; the default column is manual, so no recompute run is requested. Leave the name out to get the next free name: "New table", then "New table (2)" and onward. The person creating it owns it, and folder_id makes it inside that folder.

post/tables/

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/
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Request body

descriptionstring nullable
folder_idstring uuid nullable

The folder to make it in, as when somebody makes a table while looking inside one. Leave it out for the top level of the Tables list.

namestring nullable

Table name, unique per organisation. Leave it out for a blank table: the server names it "New table", or "New table (2)" and onward when that name is taken, checked against every table in the workspace.

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.