Endpoint#
| Property | Value |
|---|
| Type | mutation |
| Method | POST |
| Path | /api/external/v1/project_discussions/edit |
| Handler | OperatelyWeb.Api.ProjectDiscussions.Edit |
Authentication#
- Requires a valid API token.
- Requires a write-enabled token.
- Read-only tokens return
403.
| Field | Type | Required | Nullable | Default |
|---|
id | id primitive (encoded as string) | Yes | No | - |
title | string | Yes | No | - |
message | json primitive (encoded as string) | Yes | No | - |
subscriber_ids | array of id primitive (encoded as string) | No | No | [] |
Outputs#
| Field | Type | Required | Nullable |
|---|
discussion | update object | Yes | No |
cURL Example#
Copiedcurl --request POST \
--url "https://app.operately.com/api/external/v1/project_discussions/edit" \
--header "Authorization: Bearer ${OPERATELY_API_TOKEN}" \
--header "Content-Type: application/json" \
--data '{"id":"value", "message":"value", "subscriber_ids":["value"], "title":"value"}'
Response Example#
{
"discussion": {
"acknowledged": true,
"acknowledged_at": "2026-01-01T09:30:00Z",
"acknowledging_person": "<person>",
"author": "<person>",
"comments": [
"<comment>"
],
"comments_count": 123,
"content": "<update_content>",
"id": "value",
"inserted_at": "2026-01-01T09:30:00Z",
"message": "value",
"message_type": "value",
"project": "<project>",
"reactions": [
"<reaction>"
],
"title": "value",
"updatable_id": "value",
"updated_at": "2026-01-01T09:30:00Z"
}
}