---
title: "Create a new capsule"
method: POST
path: "/capsules"
---

# Create a new capsule

`POST /capsules`

## Request body

- object
  - `name` string, required — Name of the capsule. Doesn't have to be unique.

## Response `200`

Successful response

- object
  - `id` string, required — The unique ID of the capsule. Use this ID to make requests to the API. It should look something like `irrotational-airfoil`.
  - `message` string, required — A nice message from the server.

## Other responses

- `400` — Bad request
- `500` — Internal server error

## Changes

- **2024-08-26** `4f4b828ddab6` — 1 breaking, 1 info
  - removed the required property `name` from the response with the `200` status
  - added the required property `message` to the response with the `200` status
- **2024-08-26** `68792d25f28e` — 1 breaking, 1 info
  - removed the required property `capsule_id` from the response with the `200` status
  - added the required property `id` to the response with the `200` status

[Change history](https://skmtc.dev/sidhq/apis/management-api/changes/capsules/post.md)

---

[API](https://skmtc.dev/sidhq/apis/management-api.md) · [All operations](https://skmtc.dev/sidhq/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sidhq/management-api/revisions/4f4b828ddab6/schema)