Update visualization

Server: https://{kibana_url}

PUT /api/visualizations/{id}

Replaces the full configuration of an existing Lens visualization. Partial updates are not supported. To make incremental changes, retrieve the visualization first, modify the fields you need, then send the complete object back.

If no visualization exists with the specified ID, a new one is created.

ES|QL visualizations cannot be updated through this endpoint.

Path Parameters

id string required: The visualization identifier, as returned by the create or search endpoints.

Request

Responses

application/json

Created

application/json

400

Malformed request

401

Unauthorized

403

Forbidden

500

Internal Server Error

Examples

The complete updated visualization state after a full replacement. PUT replaces the entire chart configuration - fields omitted from the request are reset to their defaults. meta.created_at reflects the update time rather than the original creation time.

Request Console 1 / 2 languages

Console Kibana Dev Tools

PUT kbn:/api/visualizations/1e4f0a30-b3c5-11ef-bd7a-2b6b1a8c0f3d
{
  "type": "metric",
  "title": "Total requests (updated)",
  "data_source": {
    "type": "data_view_spec",
    "index_pattern": "kibana_sample_data_logs",
    "time_field": "timestamp"
  },
  "metrics": [
    {
      "type": "primary",
      "operation": "count"
    }
  ]
}

curl Shell

curl -X PUT "${KIBANA_URL}/api/visualizations/1e4f0a30-b3c5-11ef-bd7a-2b6b1a8c0f3d" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -H "kbn-xsrf: true" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "metric",
  "title": "Total requests (updated)",
  "data_source": {
    "type": "data_view_spec",
    "index_pattern": "kibana_sample_data_logs",
    "time_field": "timestamp"
  },
  "metrics": [
    {
      "type": "primary",
      "operation": "count"
    }
  ]
}'

Response

{
  "data": {
    "data_source": {
      "index_pattern": "kibana_sample_data_logs",
      "time_field": "timestamp",
      "type": "data_view_spec"
    },
    "ignore_global_filters": false,
    "metrics": [
      {
        "empty_as_null": false,
        "operation": "count",
        "type": "primary"
      }
    ],
    "sampling": 1,
    "styling": {
      "primary": {
        "labels": {
          "alignment": "left"
        },
        "position": "bottom",
        "value": {
          "alignment": "right",
          "sizing": "auto"
        }
      }
    },
    "tags": [],
    "title": "Total requests (updated)",
    "type": "metric"
  },
  "id": "1e4f0a30-b3c5-11ef-bd7a-2b6b1a8c0f3d",
  "meta": {
    "created_at": "2026-04-13T11:00:00.000Z",
    "managed": false,
    "updated_at": "2026-04-13T11:00:00.000Z",
    "version": "WzYxLDFd"
  }
}

{
  "data": {
    "data_source": {
      "index_pattern": "kibana_sample_data_logs",
      "time_field": "timestamp",
      "type": "data_view_spec"
    },
    "ignore_global_filters": false,
    "metrics": [
      {
        "empty_as_null": false,
        "operation": "count",
        "type": "primary"
      }
    ],
    "sampling": 1,
    "styling": {
      "primary": {
        "labels": {
          "alignment": "left"
        },
        "position": "bottom",
        "value": {
          "alignment": "right",
          "sizing": "auto"
        }
      }
    },
    "tags": [],
    "title": "Total requests (updated)",
    "type": "metric"
  },
  "id": "1e4f0a30-b3c5-11ef-bd7a-2b6b1a8c0f3d",
  "meta": {
    "created_at": "2026-04-13T11:00:00.000Z",
    "managed": false,
    "updated_at": "2026-04-13T11:00:00.000Z",
    "version": "WzYxLDFd"
  }
}