AuralisDocs
OperationsQueue operations

Create a routing team, then set its members separately

Create a routing team. Team names are unique within a workspace. Members are set separately with `PUT /v1/teams/{team_id}/members`.

/v1/teamsEditor
Operation id
create_team
Access
A viewer is refused.
POST/v1/teams

Create a routing team. Team names are unique within a workspace. Members are set separately with PUT /v1/teams/{team_id}/members.

Tenancy: the request is scoped to one workspace, and the credential presented is what selects it. A caller with no membership in that workspace is refused with 404, which is indistinguishable from a workspace that does not exist.

Authorisation: editor, admin or owner. A viewer receives 403 insufficient_role.

Access: Authorization: Bearer carrying either a realm access token or an API key. A key must hold the helpdesk-ops:write scope, and the workspace role of the person who owns it must meet the floor above.

Authorization

AuthorizationBearer <token>

A realm-issued access token, presented as Authorization: Bearer <token>. It acts as the person who signed in, and every operation resolves their workspace role live from the membership record.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/teams" \  -H "Content-Type: application/json" \  -d '{    "name": "Billing"  }'
{}