Skip to main content
POST
Create a workspace
Requires an OAuth bearer token. Supply a nonempty name. The response includes tenant_id, group_id, and name. The new group becomes the account’s selected workspace. Duplicate names and workspace ownership/membership limits return 409. 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

Response

Successful Response

group_id
integer
required
name
string | null
tenant_id
integer | null