---
title: "Update SqlDashboardBlock"
method: PATCH
path: "/api/v3/sql-dashboard-block/{sql_dashboard_block_id}"
tags: ["SQL Dashboard Block"]
---

# Update SqlDashboardBlock

`PATCH /api/v3/sql-dashboard-block/{sql_dashboard_block_id}`

## Request

- Base URL: `https://{tenant_name}.benchling.com`
- URL: `https://{tenant_name}.benchling.com/api/v3/sql-dashboard-block/{sql_dashboard_block_id}`
- Auth: HTTP bearer

Update SqlDashboardBlock.

## Path parameters

- `sql_dashboard_block_id` string, required

## Headers

- `EARLY-ACCESS` string

## Request body

- UpdateSqlDashboardBlockInput
  - `description` string: A human-readable description of the block.
  - `name` string: The display name of the block.
  - `sqlQuery` string: The SQL query executed against the Benchling data warehouse. May reference dashboard parameters using {{parameter_name}} placeholder syntax.

## Response `200`

OK

- SqlDashboardBlock: Represents a single query and visualization pane within a SqlDashboard. Each block contains a SQL query (sqlQuery) that runs against the Benchling data warehouse, along with a BlockVisualization that defines how the query results are displayed (as a chart, table, heatmap, etc.). Blocks are ordered by index within their parent dashboard and have a name and description for identification. SQL Dashboard Blocks enable users to build interactive analytics dashboards by combining multiple query-driven visualizations on a single page.
  - `__typename` string
  - `description` string
  - `id` string
  - `index` integer
  - `name` string
  - `sqlQuery` string

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `429`: Too Many Requests
- `500`: Internal Server Error

---

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