---
title: "Create a capsule"
method: POST
path: "/v3/backoffice/capsule"
tags: ["Knowledge Capsule"]
---

# Create a capsule

`POST /v3/backoffice/capsule`

## Request

- Base URL: `https://api.rhinoartisan.com`
- URL: `https://api.rhinoartisan.com/v3/backoffice/capsule`
- Auth: API key in header `apikey`
- TypeScript: <https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/docs/v3/backoffice/capsule/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a capsule in the organization. The .gh file is uploaded separately once the capsule exists.

## Request body

- object
  - `name` string, required
  - `description` string, nullable
  - `schema` object, nullable
  - `configuration_schema` object, nullable
  - `manufacturing_standards` string, nullable: Production rules of this capsule, on top of the manufacturer's (6,000 characters at most)

## Response `201`

Knowledge Capsule created successfully

## Other responses

- `400`: INVALID_PAYLOAD, MISSING_NAME, CAPSULE_NAME_ALREADY_EXISTS, INVALID_SCHEMA or INVALID_CONFIGURATION_SCHEMA
- `401`: Unauthorized
- `403`: Access denied

## Changes

- **2026-10-28** `9b069de6799a`: 1 info
  - added the new optional request property `manufacturing_standards`
- **2026-10-15** `598bac108453`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/changes/v3/backoffice/capsule/post.md)

---

[API](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api.md) - [All operations](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/revisions/f0e1d3d69cfb?raw)