Save a chart, table or dataset (Pro)

Save a chart, a table or a dataset to the user's private workspace. Needs the Pro plan; on other plans it returns PLAN_REQUIRED. Use it when the user asks to keep, save or store a chart, table or data. Chart or table of an indicator for up to 10 places, read live every time it is opened: {"kind": "chart", "title": "Unemployment, Texas vs California", "indicator": "unemployment_rate", "places": ["Texas", "California"], "from": "2015"}. Dataset of the user's own rows (up to 20,000 rows and 30 columns; an MCP request carries at most 256 KB, so send larger tables through the dashboard upload): {"kind": "dataset", "title": "Store sales 2025", "columns": ["month", "sales"], "rows": [["2025-01", 1200], ["2025-02", 1350]]}. Every row must have one value per column and column names must be unique; otherwise the call fails with INVALID_ARGUMENT naming the row. Returns {id, kind, title, size_bytes, created_at, updated_at, warnings?}. warnings names places that have no data yet and repeated titles; tell the user. The user can open it at https://invokely.ai/dashboard/workspace. To change an item later, use workspace_update, which keeps the id.

post/api/v1/workspace

Request

  • Base URL: https://invokely.ai
  • URL: https://invokely.ai/api/v1/workspace
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key
    • none

Request body

kind'chart' | 'table' | 'dataset' required

chart or table (a saved view of an indicator) or dataset (rows you provide).

titlestring required
indicatorstring

chart and table only. Indicator id from search_indicators, for example "population", "registered_unemployment_rate", "unemployment_rate", "cpi_annual_change", "net_income_per_person".

placesstring[]

chart and table only. Place names or ids.

fromstring

chart and table only. Optional first period.

tostring

chart and table only. Optional last period.

frequency'year' | 'half' | 'quarter' | 'month'

Optional. Force a frequency when the indicator exists in several (for example monthly and annual unemployment).

descriptionstring

dataset only. Optional note on what the data is.

columnsstring[]

dataset only. Column names.

Response

The saved item: {id, kind, title, size_bytes, created_at, updated_at}.

dataunknown required

Changes

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