PlanewardPlaneward Docs
PlanewardPlaneward Docs
Welcome

Developers

REST APIAuthenticationWebhooksMCPEmbedded projectsTask description contentDeveloper hub

API

List community members GETGet a community member GETList messages in a channel GETPost a message as the app POSTList channels GETList courses GETGet a course outline GETList a member's course progress GETUncomplete a module for a member DELETEComplete a module for a member PUTList the app's badges GETCreate or update a badge by key POSTUpdate a badge PATCHDelete a badge DELETERevoke a badge from a member DELETEAward a badge to a member PUTSend a notification to members POST
Community

List channels

Requires `COMMUNITY_MESSAGES_READ` (`COMMUNITY_MESSAGES_WRITE` also works, so an app that only posts can find a channel). Text and app channels the `@everyone` role can view, after category and channel overwrites, in sidebar order. App channels whose app is uninstalled or no longer available are left out. Private channels are never listed. Returns 403 when the Community module is disabled and 404 when the workspace has no community.

GET
/community/channels

Requires COMMUNITY_MESSAGES_READ (COMMUNITY_MESSAGES_WRITE also works, so an app that only posts can find a channel). Text and app channels the @everyone role can view, after category and channel overwrites, in sidebar order. App channels whose app is uninstalled or no longer available are left out. Private channels are never listed. Returns 403 when the Community module is disabled and 404 when the workspace has no community.

Authorization

x-api-key<token>

In: header

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/community/channels"
{  "data": [    {      "id": "string",      "name": "string",      "slug": "string",      "description": "string",      "kind": "TEXT",      "categoryId": "string",      "position": 0    }  ]}

Post a message as the app POST

Requires `COMMUNITY_MESSAGES_WRITE` and an app caller (`pwa_` secret); workspace API keys get 403. The channel must be a text channel in the workspace's community. The app posts with the rights of the `@everyone` role, after category and channel overwrites; staff roles never apply. If `@everyone` can't view the channel the response is 404 "Channel not found." so private channels look missing. If `@everyone` can view but not send messages the response is 403 "This app can't post in that channel.". `replyToId` must be a top-level message in the same channel (one level of replies). The message is shown live under the app's name; members cannot edit it, moderators can delete it.

List courses GET

Requires `COURSES_READ` (`COURSE_PROGRESS_WRITE` also works). Published courses members can see (sold through at least one product) in sidebar order, without their outline. `chapterCount` and `moduleCount` skip chapters without modules.