Edit

Edits the properties of an existing group.

Required scopes: WORKSPACE

Resource URL

PATCH /workspaces/:domain/groups/:group_id

URL Parameters

NameTypeDescription
domain
Required
StringThe workspace domain.
group_id
Required
IntegerThe numerical ID of the desired group.

POST Parameters

NameTypeDescription
descriptionStringThe description of the group.
nameStringThe name of the group.

Example

Request

PATCH https://api.buddy.works/workspaces/buddy/groups/1

JSON

{
  "description": "Developers"
}

Sample Response

HTTP

Status: 200 OK
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999

JSON

{
  "url": "https://api.buddy.works/workspaces/buddy/groups/1",
  "html_url": "https://app.buddy.works/buddy/group/1",
  "id": 1,
  "name": "Dev Team",
  "description": "Developers"
}

Group member

Updates the group member's status.

Required scopes: WORKSPACE

Resource URL

PATCH /workspaces/:domain/groups/:group_id/members/:member_id

URL Parameters

NameTypeDescription
domain
Required
StringThe workspace domain.
group_id
Required
IntegerThe numerical ID of the desired group.
member_id
Required
IntegerThe numerical ID of the desired user.

PATCH Parameters

NameTypeDescription
status
Required
StringThe group member status. Can be one of: MEMBER, MANAGER

Example

Request

PATCH https://api.buddy.works/workspaces/buddy/groups/1/members/1

JSON

{
  "status": "MANAGER"
}

Sample Response

HTTP

Status: 200 OK
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999

JSON

{
  "url": "https://api.buddy.works/workspaces/buddy/groups/1/members/1",
  "html_url": "https://app.buddy.works/buddy/profile/1",
  "id": 1,
  "name": "Mike Benson",
  "avatar_url": "https://app.buddy.works/image-server/user/0/0/0/0/0/0/1/d643744fbe5ebf2906a4d075a5b97110/w/32/32/AVATAR.png",
  "admin": true,
  "workspace_owner": true,
  "status": "MANAGER"
}

Last modified on July 26, 2022

Get Started

Sign up for free and deploy your project in less than 10 minutes.