---
title: "Change a workspace item in place (Pro)"
method: PATCH
path: "/api/v1/workspace/{id}"
---

# Change a workspace item in place (Pro)

`PATCH /api/v1/workspace/{id}`

## Request

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

Change a saved chart, table or dataset in place. The id stays the same, so links and references keep working. Pass the id and only the fields to change. Needs the Pro plan.
Charts and tables: title, kind ("chart" or "table"), indicator, places, from, to, frequency; null clears from, to or frequency. Example: {"id": "wsp_3f9a...", "places": ["Texas", "California", "Florida"], "from": null}.
Datasets: title, description (null clears it), columns, rows. Rows replace all existing rows; send columns too when their number changes.
Returns {id, kind, title, size_bytes, created_at, updated_at, warnings?}.

## Path parameters

- `id` string, required

## Request body

- object
  - `title` string
  - `kind` 'chart' | 'table': Charts and tables only: switch how the view is shown.
  - `indicator` string: Indicator id from search_indicators, for example "population", "registered_unemployment_rate", "unemployment_rate", "cpi_annual_change", "net_income_per_person".
  - `places` string[]
  - `from` string, nullable: First period, or null to clear.
  - `to` string, nullable: Last period, or null to clear.
  - `frequency` 'year' | 'half' | 'quarter' | 'month' | 'null', nullable
  - `description` string, nullable
  - `columns` string[]
  - `rows` array[]
    - union[]
      - union
        - string
        - number

## Response `200`

The changed item: {id, kind, title, size_bytes, created_at, updated_at, warnings?}.

- Data
  - `data` unknown, required

## Other responses

- `400`: Invalid argument (INVALID_ARGUMENT).
- `401`: API key required (UNAUTHORIZED).
- `402`: Editing is part of the Pro plan (PLAN_REQUIRED).
- `404`: No such item (ITEM_NOT_FOUND).

---

[API](https://skmtc.dev/invokely/apis/invokely-statistics-api.md) · [All operations](https://skmtc.dev/invokely/apis/invokely-statistics-api/llms.txt) · [OpenAPI document](https://skmtc.dev/invokely/apis/invokely-statistics-api/revisions/3b0f775bccb6?raw)