---
title: "Create Ceph User"
method: POST
path: "/api/cluster/user"
tags: ["Cluster"]
---

# Create Ceph User

`POST /api/cluster/user`

Add a Ceph user, with its defined capabilities.

## Request body

- object
  - `capabilities` object[] — List of capabilities to add to user_entity
    - `cap` string, required — Capability to add; eg. allow *
    - `entity` string, required — Entity to add
  - `import_data` string
  - `user_entity` string — Entity to add

## Response `201`

Resource created.

- object

## Other responses

- `202` — Operation is still executing. Please check the task queue.
- `400` — Operation exception. Please check the response body for details.
- `401` — Unauthenticated access. Please login first.
- `403` — Unauthorized access. Please check your permissions.
- `500` — Unexpected error. Please check the response body for the stack trace.

---

[API](https://skmtc.net/ceph/apis/ceph-rest-api.md) · [All operations](https://skmtc.net/ceph/apis/ceph-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ceph/ceph-rest-api/versions/b03ae23c3806/schema)
