Create a new group

Creates a new group. Restricted to admins only.

Required scopes: WORKSPACE

Resource URL

POST /workspaces/:domain/groups

URL Parameters

NameTypeDescription
domain
Required
StringThe workspace domain.

POST Parameters

NameTypeDescription
name
Required
StringThe name of the group.
descriptionStringThe description of the group.

Example

Request

POST https://api.buddy.works/workspaces/buddy/groups

JSON

{
"name": "JAVA",
"description": "Java developers"
}

Sample Response

HTTP

Status: 201 Created
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": "JAVA",
"description": "Java developers"
}