---
title: "Modify an existing ensemble"
method: PATCH
path: "/ensembles/{em-name}"
tags: ["Ensemble"]
---

# Modify an existing ensemble

`PATCH /ensembles/{em-name}`

Configure max_planning and/or max_running for the given ensemble. max_planning
limits the number of workflows in the ensemble that can be planned concurrently.
max_running limits the number of workflows in the ensemble that can be running
concurrently. These parameters are set to 1 by default.

## Request body

- object
  - `max_planning` integer
  - `max_running` integer

## Response `200`

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
- `404` — Resource not found
- `default` — Internal server error

## Changes

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

- **2021-01-12** `c4d83189c07b` — 2 info
  - endpoint added
  - added the new optional `query` request parameter `pretty-print` to all path's operations
- **2021-01-11** `c605463405d9` — 1 breaking
  - api removed without deprecation

[Change history](https://skmtc.dev/pegasus-isi/apis/ensemble-manager-api/changes/ensembles/:em-name/patch.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)