---
title: "Creates a worker group"
method: POST
path: "/v1/worker-groups"
tags: ["worker groups"]
---

# Creates a worker group

`POST /v1/worker-groups`

## Query parameters

- `org` string

## Headers

- `X-Fields` string, mask

## Request body

- CreateWorkerGroup
  - `name` string, required
  - `workerIds` integer[]

## Response `200`

Success

- WorkerGroup
  - `id` integer
  - `created` string
  - `name` string
  - `ownerId` integer
  - `workers` Worker[]
    - `id` integer
    - `status` 'INVITED' | 'ACTIVE' | 'INACTIVE'
    - `type` 'USER' | 'CROWD' | 'BOT' | 'AI'
    - `invited` string, date-time
    - `accepted` string, date-time
    - `created` string, date-time
    - `userId` integer
    - `userEmail` string
    - `userUsername` string

---

[API](https://skmtc.net/super/apis/super-ai-api.md) · [All operations](https://skmtc.net/super/apis/super-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/super/super-ai-api/revisions/d2c17db7266d/schema)