---
title: "Create persistent volume claim"
method: POST
path: "/persistentvolumeclaims/{namespace}"
tags: ["persistentvolumeclaims"]
---

# Create persistent volume claim

`POST /persistentvolumeclaims/{namespace}`

Creates a new persistent volume claim in the specified namespace.

## Path parameters

- `namespace` string, required

## Request body

- ApiPVCCreateEnvelope
  - `data` PvcsPVCCreate, required
    - `accessModes` V1PersistentVolumeAccessMode[], required
    - `name` string, required
    - `requests` PvcsStorageRequestsMutate, required
      - `storage` string, required
    - `storageClassName` string, required

## Response `201`

PVC created successfully

- ApiPVCCreateEnvelope
  - `data` PvcsPVCCreate, required
    - `accessModes` V1PersistentVolumeAccessMode[], required
    - `name` string, required
    - `requests` PvcsStorageRequestsMutate, required
      - `storage` string, required
    - `storageClassName` string, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `409` — PVC already exists
- `413` — Request Entity Too Large. The request body is too large.
- `415` — Unsupported Media Type. Content-Type header is not correct.
- `422` — Unprocessable Entity. Validation error.
- `500` — Internal server error

## Changes

- **2026-04-09** `e9c6319e31be` — 1 info
  - endpoint added
- **2026-01-30** `e4dc5b696346` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/opendatahub-io/apis/kubeflow-notebooks-api/changes/persistentvolumeclaims/:namespace/post.md)

---

[API](https://skmtc.dev/opendatahub-io/apis/kubeflow-notebooks-api.md) · [All operations](https://skmtc.dev/opendatahub-io/apis/kubeflow-notebooks-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opendatahub-io/kubeflow-notebooks-api/revisions/97fe86faf733/schema)