Groups

List groups

Returns all groups in the workspace according to the "Who can see what?" article in the help guide
Required scopes: WORKSPACE

Resource URL

GET
/workspaces/:domain/groups

URL Parameters

Name Description
domain Required String The workspace domain.

Example

Request
GET
https://api.buddy.works/workspaces/buddy/groups
Sample Response
Status: 200 OK
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999
{
  "url": "https://api.buddy.works/workspaces/buddy/groups",
  "html_url": "https://app.buddy.works/buddy/people",
  "groups": [
    {
      "url": "https://api.buddy.works/workspaces/buddy",
      "html_url": "https://app.buddy.works/buddy/group/1",
      "id": 1,
      "name": "Dev Team",
      "description": "Developers"
    }
  ]
}

Create

Creates a new group. Restricted to admins only.
Required scopes: WORKSPACE

Resource URL

POST
/workspaces/:domain/groups

URL Parameters

Name Description
domain Required String The workspace domain.

POST Parameters

Name Description
name Required String The name of the group.
description String The description of the group.

Example

Request
POST
https://api.buddy.works/workspaces/buddy/groups
{
  "name": "JAVA",
  "description": "Java developers"
}
Sample Response
Status: 201 Created
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999
{
  "url": "https://api.buddy.works/workspaces/buddy/groups/1",
  "html_url": "https://app.buddy.works/buddy/group/1",
  "id": 1,
  "name": "JAVA",
  "description": "Java developers"
}

Get

Returns a single group.
Required scopes: WORKSPACE

Resource URL

GET
/workspaces/:domain/groups/:group_id

URL Parameters

Name Description
domain Required String The workspace domain.
group_id Required Integer The numerical ID of the desired group.

Example

Request
GET
https://api.buddy.works/workspaces/buddy/groups/1
Sample Response
Status: 200 OK
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999
{
  "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"
}

Edit

Updates existent group properties.
Required scopes: WORKSPACE

Resource URL

PATCH
/workspaces/:domain/groups/:group_id

URL Parameters

Name Description
domain Required String The workspace domain.
group_id Required Integer The numerical ID of the desired group.

POST Parameters

Name Description
description String The description of the group.
name String The name of the group.

Example

Request
PATCH
https://api.buddy.works/workspaces/buddy/groups/1
{
  "description": "Developers"
}
Sample Response
Status: 200 OK
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999
{
  "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"
}

Delete

Deletes a group.
Required scopes: WORKSPACE

Resource URL

DELETE
/workspaces/:domain/groups/:group_id

URL Parameters

Name Description
domain Required String The workspace domain.
group_id Required Integer The numerical ID of the desired group.

Example

Request
DELETE
https://api.buddy.works/workspaces/buddy/groups/1
Sample Response
Status: 204 NoContent
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999

List group members

Returns all members from the group.
Required scopes: WORKSPACE

Resource URL

GET
/workspaces/:domain/groups/:group_id/members

URL Parameters

Name Description
domain Required String The workspace domain.
group_id Required Integer The numerical ID of the desired group.

Example

Request
GET
https://api.buddy.works/workspaces/buddy/groups/1/members
Sample Response
Status: 200 OK
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999
{
  "url": "https://api.buddy.works/workspaces/buddy/groups/1/members",
  "html_url": "https://app.buddy.works/buddy/group/1/members",
  "members": [
    {
      "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",
      "title": "Creative director"
    }
  ]
}

Add a group member

Adds a user to the group.
Required scopes: WORKSPACE

Resource URL

POST
/workspaces/:domain/groups/:group_id/members

URL Parameters

Name Description
domain Required String The workspace domain.
group_id Required Integer The numerical ID of the desired group.

POST Parameters

Name Description
id Required Integer The numerical ID of the desired user.

Example

Request
POST
https://api.buddy.works/workspaces/buddy/groups/1/members
{
  "id": 1
}
Sample Response
Status: 201 Created
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999
{
  "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",
  "title": "Creative director",
  "admin": true,
  "workspace_owner": true
}

Get a group member

Returns a single member of the group.
Required scopes: WORKSPACE

Resource URL

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

URL Parameters

Name Description
domain Required String The workspace domain.
group_id Required Integer The numerical ID of the desired group.
member_id Required Integer The numerical ID of the desired user.

Example

Request
GET
https://api.buddy.works/workspaces/buddy/groups/1/members/1
Sample Response
Status: 200 OK
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999
{
  "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",
  "title": "Creative director",
  "admin": true,
  "workspace_owner": true
}

Delete a group member

Removes a member from the group.
Required scopes: WORKSPACE

Resource URL

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

URL Parameters

Name Description
domain Required String The workspace domain.
group_id Required Integer The numerical ID of the desired group.
member_id Required Integer The numerical ID of the desired user.

Example

Request
DELETE
https://api.buddy.works/workspaces/buddy/groups/1/members/1
Sample Response
Status: 204 NoContent
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999
esc

Sign up for free

No setup fees. No requirements. No obligation.

or sign up with