# Update project scenario description

`PATCH` `/api/v1/carve/projects/{project_id}/scenarios/{scenario_id}/description`

Set or clear the human-readable description for a scenario. Pass null to clear it.

## Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| project_id | string | yes | — |
| scenario_id | string | yes | — |

## Request body

`application/json`

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| description | string | no | New description. Pass null to clear it. |

## Response

`200 OK` — `application/json`

| Field | Type | Description |
|-------|------|-------------|
| scenario_id | string | — |
| project_id | string | — |
| description | string | — |
| message | string | — |

## Errors

| Status | Description |
|--------|-------------|
| 403 | Forbidden |
| 404 | Not Found |
| 422 | Unprocessable Entity |
| 502 | Bad Gateway |