---
title: "Update DataTable"
method: PUT
path: "/dataTables/{data_table_id}"
tags: ["DataTable"]
---

# Update DataTable

`PUT /dataTables/{data_table_id}`

Update the DataTable name and/or description. Use the [update variables](https://api.help.mabl.com/reference/updatevariablename) and [update scenario](https://api.help.mabl.com/reference/putscenario) endpoints to update the contents of a DataTable.

## Path parameters

- `data_table_id` string, required

## Request body

- DataTable
  - `id` string
  - `workspace_id` string — The ID of the workspace associated with this DataTable
  - `name` string — The display name for the DataTable
  - `description` string, nullable — The Description for the DataTable
  - `scenario_ids` string[] — The row (scenario) IDs contained in DataTable
  - `created_time` integer — Time at which the entity was created
  - `created_by_id` string — The ID of the user who created this entity
  - `last_updated_time` integer — Time at which the entity was last updated
  - `last_updated_by_id` string — The ID of the user who last updated this entity
  - `resource_groups` DerivedResourceGroup[] — Resource groups this resource belongs to
    - `resource_group_id` string — ID of the resource group
    - `short_name` string — Name of the resource group
    - `parent_id` string — ID of the parent to which this ResourceGroup belongs
    - `parent_namespace` 'workspaces' — Namespace of the parent to which this ResourceGroup belongs
  - `used_by_test_count` integer — Count of tests using this DataTable. Populated in query responses.

## Response `200`

The updated DataTable

- DataTable
  - `id` string
  - `workspace_id` string — The ID of the workspace associated with this DataTable
  - `name` string — The display name for the DataTable
  - `description` string, nullable — The Description for the DataTable
  - `scenario_ids` string[] — The row (scenario) IDs contained in DataTable
  - `created_time` integer — Time at which the entity was created
  - `created_by_id` string — The ID of the user who created this entity
  - `last_updated_time` integer — Time at which the entity was last updated
  - `last_updated_by_id` string — The ID of the user who last updated this entity
  - `resource_groups` DerivedResourceGroup[] — Resource groups this resource belongs to
    - `resource_group_id` string — ID of the resource group
    - `short_name` string — Name of the resource group
    - `parent_id` string — ID of the parent to which this ResourceGroup belongs
    - `parent_namespace` 'workspaces' — Namespace of the parent to which this ResourceGroup belongs
  - `used_by_test_count` integer — Count of tests using this DataTable. Populated in query responses.

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `404` — DataTable not found
- `default` — Unknown error

---

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