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

Update a badge

Requires `COMMUNITY_BADGES_WRITE` and an app caller. Only the app's own badges; others are 404. `key` can't change.

PATCH
/community/badges/{badgeId}

Requires COMMUNITY_BADGES_WRITE and an app caller. Only the app's own badges; others are 404. key can't change.

Authorization

x-api-key<token>

In: header

Path Parameters

badgeId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Properties1 <= properties

Response Body

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/community/badges/string" \  -H "Content-Type: application/json" \  -d '{}'
{  "data": {    "id": "string",    "appId": "string",    "key": "string",    "name": "string",    "description": "string",    "color": "string",    "iconUrl": "string",    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z"  }}

Create or update a badge by key POST

Requires `COMMUNITY_BADGES_WRITE` and an app caller. `key` is the app's stable slug for the badge: posting an existing key updates that badge (200), a new key creates one (201). Badges belong to the app in this workspace, so they come back with their awards after a reinstall. An app can have at most 50 badges per workspace; a new key past that is 409.

Delete a badge DELETE

Requires `COMMUNITY_BADGES_WRITE` and an app caller. Deletes the badge and every award of it. No `community.badge.revoked` events are sent.

name?string
Length1 <= length <= 40
description?string
Lengthlength <= 200
color?string
Match^#[0-9a-fA-F]{6}$