---
title: "Create an ensemble"
method: POST
path: "/ensembles"
tags: ["Ensemble"]
---

# Create an ensemble

`POST /ensembles`

Creates a new ensemble with the given name.

## Request body

- object
  - `name` string

## Response `201`

Success

- Ensemble
  - `id` integer, required
  - `name` string, required
  - `created` string, date-time, required
  - `updated` string, date-time, required
  - `state` 'ACTIVE' | 'HELD' | 'PAUSED', required
  - `max_running` integer, required
  - `max_planning` integer, required

## Other responses

- `400` — Bad request
- `401` — Not authenticated
- `default` — Internal server error

## Changes

> 4 revisions in range; 1 could not be searched.

- **2021-01-12** `c4d83189c07b` — 1 breaking, 3 info
  - removed the success response with the status `200`
  - api tag `Ensemble` added
  - added the new optional `query` request parameter `pretty-print` to all path's operations
  - added the success response with the status `201`
- **2021-01-11** `c605463405d9` — 1 breaking, 2 info
  - removed the success response with the status `201`
  - api tag `Ensemble` removed
  - added the success response with the status `200`

[Change history](https://skmtc.dev/pegasus-isi/apis/ensemble-manager-api/changes/ensembles/post.md)

---

[API](https://skmtc.dev/pegasus-isi/apis/ensemble-manager-api.md) · [All operations](https://skmtc.dev/pegasus-isi/apis/ensemble-manager-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pegasus-isi/ensemble-manager-api/revisions/bc40e50a342a/schema)