Skip to main content
POST
Create a workspace group
Requires an OAuth bearer token and Admin or Owner access to the supplied tenant. Send tenant_id and a nonempty name. Returns the new group_id and makes it the selected group. The creator becomes the group owner. API keys are not accepted.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Body

application/json
name
string
required
tenant_id
integer
required

Response

Successful Response

group_id
integer
required
name
string | null
tenant_id
integer | null