---
title: "Update an existing table"
method: PATCH
path: "/v1/org/{orgId}/table/{tableId}"
tags: ["table"]
---

# Update an existing table

`PATCH /v1/org/{orgId}/table/{tableId}`

## Path parameters

- `orgId` string, required
- `tableId` string, required

## Request body

- UpdateTable
  - `name` string — name of table
  - `label` string — human readable label for the table
  - `labelColumnId` string — if set, use this column id as the label when referencing rows
  - `effectiveDated` boolean — whether or not the table is time tracked with effective dates (allows time travel or not). If false, then the values set in the table will be the same across all dates.
  - `sensitive` 'GLOBAL' | 'ORG' | 'SENSITIVE' | 'PERSONAL' | 'MANAGER' | 'HIGH' | 'PRIVATE' — base sensitivity of this table and entities in it -- should be either ORG or HIGH
  - `shareAccess` ShareAccess[] — users who are specifically granted permission to this table
    - `access` 'NONE' | 'LIMITED_READ' | 'LIMITED_WRITE' | 'STANDARD_READ' | 'STANDARD_WRITE' | 'COMPENSATION_READ' | 'FULL_READ' | 'COMP_PLANNING_PARTICIPANT' | 'COMPENSATION_WRITE' | 'WRITE' | 'COMPENSATION_OWNER' | 'OWNER', required — access permission level
    - `userId` string — user id
    - `groupId` string — group id
    - `fields` string — fields

## Response `204`

table updated

## Other responses

- `400` — invalid data
- `401` — not authorized
- `403` — permission denied
- `404` — not found

---

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