---
title: "Rename columns by name"
method: POST
path: "/dataset/{handle}/rename-columns/by-name"
tags: ["data"]
---

# Rename columns by name

`POST /dataset/{handle}/rename-columns/by-name`

Renames the columns in the sheet using column names.

## Path parameters

- `handle` string, required

## Request body

- FilesRenameColumnsRequest
  - `rename_columns` FilesRenameColumn[], required
    - `current_name` string, required
    - `new_name` string, required

## Response `200`

OK

- unknown

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

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