---
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`

## Request

- Base URL: `//api.gigasheet.com` (relative, and the document’s source URL is not known)
- URL: `//api.gigasheet.com/dataset/{handle}/rename-columns/by-name`
- Auth: API key in header `X-GIGASHEET-TOKEN`
- TypeScript: <https://skmtc.dev/freshdesk/apis/gigasheet-api/docs/dataset/:handle/rename-columns/by-name/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/freshdesk/apis/gigasheet-api.md) - [All operations](https://skmtc.dev/freshdesk/apis/gigasheet-api/llms.txt) - [OpenAPI document](https://skmtc.dev/freshdesk/apis/gigasheet-api/revisions/d1e5cbb24557?raw)