---
title: "Update a capsule"
method: POST
path: "/v3/backoffice/capsule/{id}"
tags: ["Knowledge Capsule"]
---

# Update a capsule

`POST /v3/backoffice/capsule/{id}`

## Request

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

Partial update: only the fields present in the body change. Send schema or configuration_schema as null to clear them.

## Path parameters

- `id` integer, required

## Request body

- object
  - `name` string
  - `uuid` string, uuid: Stable id kept when importing a capsule exported from another account; unique per organization
  - `description` string, nullable
  - `status` integer: 0 draft, 1 ready, 2 published
  - `tags` 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 `200`

Knowledge Capsule updated successfully

## Other responses

- `400`: INVALID_PAYLOAD, MISSING_NAME, CAPSULE_NAME_ALREADY_EXISTS, INVALID_UUID, CAPSULE_UUID_ALREADY_EXISTS, INVALID_STATUS, INVALID_TAGS, INVALID_SCHEMA or INVALID_CONFIGURATION_SCHEMA
- `401`: Unauthorized
- `403`: Access denied
- `404`: CAPSULE_NOT_FOUND

## 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/:id/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)