---
type: api
title: Upsert visualization
description: > This documentation is temporarily hosted at a separate location.
url: https://www.elastic.co/elastic/docs-builder/docs/4493/api/doc/kibana-serverless/operation/operation-upsert-visualization
resource: https://www.elastic.co/elastic/docs-builder/docs/4493/api/doc/kibana-serverless/operation/operation-upsert-visualization
products:
  - Kibana
---

# Upsert visualization

- Server: `https://{kibana_url}`

## Paths

- `PUT` `/api/visualizations/{id}`

## Description

> This documentation is temporarily hosted at a separate location.
>
> **[View the full Visualizations API reference →](https://elastic.github.io/dashboards-api-spec/visualizations#tag/Visualizations)**

## Authentication

- Api key: `Authorization: <value>`
  You must create an API key and use the encoded value in the request header. To learn about creating keys, go to [API keys](https://www.elastic.co/docs/current/serverless/api-keys).

## Response

See the full Visualizations API reference for detailed response schemas.

## Code examples

#### Console

```console
PUT kbn:/api/visualizations/ID
```

#### curl

```curl
curl -X PUT "${KIBANA_URL}/api/visualizations/${ID}" \
  -H "Authorization: ApiKey ${API_KEY}"
```