Projects API: List discussions
Endpoint#
Section titled “Endpoint#”| Property | Value |
|---|---|
| Type | query |
| Method | GET |
| Path | /api/external/v1/projects/list_discussions |
| Handler | OperatelyWeb.Api.Projects.Discussions.List |
Authentication#
Section titled “Authentication#”- Requires a valid API token.
- Read-only and full-access tokens can execute this query.
| Field | Type | Required | Nullable | Default |
|---|---|---|---|---|
project_id | id primitive (encoded as string) | Yes | No | - |
Outputs#
Section titled “Outputs#”| Field | Type | Required | Nullable |
|---|---|---|---|
discussions | array of comment_thread object | Yes | No |
cURL Example#
Section titled “cURL Example#”Copied
curl --request GET \
--url "https://app.operately.com/api/external/v1/projects/list_discussions?project_id=value" \
--header "Authorization: Bearer ${OPERATELY_API_TOKEN}"Response Example#
Section titled “Response Example#”{ "discussions": [ { "__typename": "value", "acknowledged_at": "2026-01-01T09:30:00Z", "acknowledged_by": "<person>", "author": "<person>", "can_comment": true, "comments": [ "<comment>" ], "comments_count": 123, "id": "value", "inserted_at": "2026-01-01", "message": "value", "notifications": [ "<notification>" ], "potential_subscribers": [ "<subscriber>" ], "project": "<project>", "project_permissions": "<project_permissions>", "reactions": [ "<reaction>" ], "space": "<space>", "subscription_list": "<subscription_list>", "title": "value" } ]}