---
title: "Webalize Display Name"
method: POST
path: "/v2/storage/webalize/display-name"
tags: ["Webalize"]
---

# Webalize Display Name

`POST /v2/storage/webalize/display-name`

## Request

- Base URL: `https://connection.keboola.com`
- URL: `https://connection.keboola.com/v2/storage/webalize/display-name`
- Auth: one of:
  - API key in header `X-StorageApi-Token`
  - API key in header `X-KBC-ManageApiToken`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/keboola/apis/keboola-storage-api/docs/v2/storage/webalize/display-name/post.ts> (a function with typed inputs; its response is checked against the schema)

Webalize string which you want to use as `displayName` for tables (`PUT /tables/{tableId}`)
and buckets (`PUT /buckets/{bucketId}`).

## Request body

- WebalizeDisplayNameRequest
  - `displayName` string, required: Display name to webalize.

## Response `200`

Webalized display name.

- WebalizeDisplayNameResponse
  - `displayName` string, required: The name of a bucket or a table. - Allowed characters: `A-Z`, `a-z`, `0-9`, dash `-` and underscore `_`. Anything else — a space, a dot, an accented letter — is rejected, not transliterated. - 1 to 96 characters. - Cannot start with an underscore. A dash or a digit as the first character is fine. - Registered (external) buckets follow this same rule, dashes included. - Uniqueness is case-insensitive within a stage: creating `MyBucket` next to `mybucket` fails with `storage.buckets.alreadyExists`, and for tables with `storage.buckets.tableAlreadyExists` or `storage.validation.tableAlreadyExists`. - To turn arbitrary user input into a name that satisfies this rule, call `POST /v2/storage/webalize/display-name` instead of reimplementing the transformation. It unaccents the input, replaces every run of disallowed characters with a single `-`, trims `-` from both ends, strips leading underscores, and truncates to 96 characters.

## Other responses

- `422`: Display name cannot be webalized to a valid value (`storage.webalize.displayName.invalid`).

---

[API](https://skmtc.dev/keboola/apis/keboola-storage-api.md) - [All operations](https://skmtc.dev/keboola/apis/keboola-storage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/keboola/apis/keboola-storage-api/revisions/34b5ceac0317?raw)