Sign in

v46

latestOpenAPI 3.0.0MITraw.githubusercontent.com2026-08-0311978417.1 KB
Datasources

Upsert a table

Upsert a table in the data source identified by {dsId} in the workspace identified by {wId}.

post/api/v1/w/{wId}/spaces/{spaceId}/data_sources/{dsId}/tables

Path parameters

wIdstring required

Unique string identifier for the workspace

spaceIdstring required

ID of the space

dsIdstring required

ID of the data source

Request body

namestring

Name of the table

titlestring

Title of the table

table_idstring

Unique identifier for the table

descriptionstring

Description of the table

timestampnumber

Unix timestamp (in milliseconds) for the table (e.g. 1736365559000).

tagsstring[]

Tags associated with the table

mime_typestring

Reserved for internal use, should not be set. Mime type of the table

Response

The table

namestring

Name of the table

titlestring

Title of the table

table_idstring

Unique identifier for the table

descriptionstring

Description of the table

mime_typestring

MIME type of the table

timestampnumber

Unix timestamp of table creation/modification

tagsstring[]

Array of tags associated with the table

parent_idstring

ID of the table parent

parentsstring[]

Array of parent table IDs

Example response

{
  "name": "Roi data",
  "title": "ROI Data",
  "table_id": "1234f4567c",
  "description": "roi data for Q1",
  "mime_type": "text/csv",
  "schema": [
    {
      "name": "roi",
      "value_type": "int",
      "possible_values": [
        "1",
        "2",
        "3"
      ]
    }
  ],
  "timestamp": 1732810375150,
  "parent_id": "1234f4567c",
  "parents": [
    "1234f4567c"
  ]
}