---
title: "PUT /workspaces/{workspaceId}/configuration"
method: PUT
path: "/workspaces/{workspaceId}/configuration"
---

# PUT /workspaces/{workspaceId}/configuration

`PUT /workspaces/{workspaceId}/configuration`

Updates the configuration string for the given workspace

## Path parameters

- `workspaceId` string, required

## Request body

- object
  - `configuration` string, required — The new configuration string for the workspace. For more information about the format and configuration options available, see <a href="https://docs.aws.amazon.com/grafana/latest/userguide/AMG-configure-workspace.html">Working in your Grafana workspace</a>.
  - `grafanaVersion` string — <p>Specifies the version of Grafana to support in the workspace. If not specified, keeps the current version of the workspace.</p> <p>Can only be used to upgrade (for example, from 8.4 to 9.4), not downgrade (for example, from 9.4 to 8.4).</p> <p>To know what versions are available to upgrade to for a specific workspace, see the <a href="https://docs.aws.amazon.com/grafana/latest/APIReference/API_ListVersions.html">ListVersions</a> operation.</p>

## Response `202`

Success

- UpdateWorkspaceConfigurationResponse

## Other responses

- `480` — ResourceNotFoundException
- `481` — ThrottlingException
- `482` — ConflictException
- `483` — ValidationException
- `484` — AccessDeniedException
- `485` — InternalServerException

---

[API](https://skmtc.net/aws/apis/grafana.md) · [All operations](https://skmtc.net/aws/apis/grafana/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/grafana/versions/76cc5bd3d508/schema)