---
title: "/discussions/:discussionId"
method: PATCH
path: "/v1/discussions/{discussionId}"
tags: ["Discussions"]
---

# /discussions/:discussionId

`PATCH /v1/discussions/{discussionId}`

## Request

- Base URL: `api.air.inc` (relative, and the document’s source URL is not known)
- URL: `api.air.inc/v1/discussions/{discussionId}`
- Auth: one of:
  - API key in header `x-api-key` and API key in header `x-air-workspace-id`
  - HTTP bearer and API key in header `x-air-workspace-id`
- TypeScript: <https://skmtc.dev/air/apis/air-api/docs/v1/discussions/:discussionId/patch.ts> (a function with typed inputs; its response is checked against the schema)

Resolve or reopen a discussion.

The response is 204 with no body, including when the discussion was
already in the requested state.

Requires the `comments.write` OAuth scope.

## Request body

- object
  - `resolved` boolean, required: `true` resolves the discussion. `false` reopens it.

## Response `204`

Resolved state updated. No response body.

## Other responses

- `400`: `resolved` is missing or not a boolean
- `403`: You cannot manage discussions on this asset
- `404`: Discussion not found

## Changes

- **2026-11-03** `8e6005b272a1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/air/apis/air-api/changes/v1/discussions/:discussionId/patch.md)

---

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