For the complete documentation index, see llms.txt. This page is also available as Markdown.

Creates a new discussion linked to the target document

POST /api/v1/policy-comments/{policyId}/{documentId}/discussions

Creates a new discussion thread linked to the target document.

Authentication: Bearer token required (Authorization: Bearer <token>)

Permission: Permissions.POLICIES_POLICY_EXECUTE or Permissions.POLICIES_POLICY_MANAGE


Request

Path Parameters

Parameter
Type
Required
Description

policyId

string

Yes

Policy identifier

documentId

string

Yes

Document identifier

Request Body

{
  "title": "Query about facility capacity value",
  "message": "The reported capacity of 500 MWh seems high — please verify."
}
Field
Type
Required
Description

title

string

Yes

Discussion title or subject

message

string

No

Optional initial message body


Response

Success Response

Status: 201 Created

Error Responses

Status
Description

401 Unauthorized

Missing or invalid token

403 Forbidden

Insufficient permissions

422 Unprocessable Entity

Validation error — invalid field values

500 Internal Server Error

Unexpected server failure

Last updated

Was this helpful?