---
title: "Update a planning table"
method: PATCH
path: "/tables/{id}"
tags: ["Planning Table"]
---

# Update a planning table

`PATCH /tables/{id}`

Planning tables store a typed column schema (number, text, dimension, and calculated columns).

A calculated column's output type is inferred from its formula on save and controls whether numeric formatting applies; formulas with an ambiguous type or invalid dimension usage are rejected.

## Path parameters

- `id` string, required

## Headers

- `X-Company-ID` string, required

## Request body

- PatchedPlanningTable — Mixin to delegate create, update, and destroy operations to a service class.
  - `id` integer
  - `company_id` string, uuid
  - `created_at` string, date-time
  - `modified_at` string, date-time
  - `name` string
  - `sharing_scheme` 'ALL' | 'MANAGERS' | 'SPECIFIC' — * `ALL` - All Team Members * `MANAGERS` - Managers Only * `SPECIFIC` - Specific Users
  - `schema` unknown
  - `schema_reviewed` boolean
  - `erp_connection_id` string, uuid, nullable
  - `created_by_id` integer
  - `modified_by_id` integer
  - `has_templates` boolean
  - `shared_with` string[]

## Response `200`

- PlanningTable — Mixin to delegate create, update, and destroy operations to a service class.
  - `id` integer, required
  - `company_id` string, uuid, required
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, required
  - `name` string, required
  - `sharing_scheme` 'ALL' | 'MANAGERS' | 'SPECIFIC' — * `ALL` - All Team Members * `MANAGERS` - Managers Only * `SPECIFIC` - Specific Users
  - `schema` unknown, required
  - `schema_reviewed` boolean
  - `erp_connection_id` string, uuid, nullable, required
  - `created_by_id` integer, required
  - `modified_by_id` integer, required
  - `has_templates` boolean, required
  - `shared_with` string[]

---

[API](https://skmtc.net/cubesoftware/apis/cube-api.md) · [All operations](https://skmtc.net/cubesoftware/apis/cube-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cubesoftware/cube-api/revisions/67d9f45bb99b/schema)