---
title: "Create Work Pool"
method: POST
path: "/api/work_pools/"
tags: ["Work Pools"]
---

# Create Work Pool

`POST /api/work_pools/`

Creates a new work pool. If a work pool with the same
name already exists, an error will be raised.

## Headers

- `x-prefect-api-version` string

## Request body

- WorkPoolCreate — Data used by the Prefect REST API to create a work pool.
  - `name` string, required — The name of the work pool.
  - `description` string — The work pool description.
  - `type` string — The work pool type.
  - `base_job_template` object — The work pool's base job template.
  - `is_paused` boolean — Pausing the work pool stops the delivery of all work.
  - `concurrency_limit` integer — A concurrency limit for the work pool.

## Response `201`

Successful Response

- WorkPool — An ORM representation of a work pool
  - `id` string, uuid
  - `created` string, date-time
  - `updated` string, date-time
  - `name` string, required — The name of the work pool.
  - `description` string — A description of the work pool.
  - `type` string, required — The work pool type.
  - `base_job_template` object — The work pool's base job template.
  - `is_paused` boolean — Pausing the work pool stops the delivery of all work.
  - `concurrency_limit` integer — A concurrency limit for the work pool.
  - `status` 'READY' | 'NOT_READY' | 'PAUSED' — Enumeration of work pool statuses.
  - `default_queue_id` string, uuid — The id of the pool's default queue.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/prefecthq/apis/untitled-api-2.md) · [All operations](https://skmtc.net/prefecthq/apis/untitled-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prefecthq/untitled-api-2/revisions/29ba6c4f8837/schema)