---
title: "Delete User Schema V1"
method: DELETE
path: "/v1/schemas/{schema_id}"
tags: ["v1", "Schema Management"]
---

# Delete User Schema V1

`DELETE /v1/schemas/{schema_id}`

Delete a schema.
    
    Soft deletes the schema by marking it as archived. The schema data and
    associated graph nodes/relationships are preserved for data integrity.
    User must have write access to the schema.

## Path parameters

- `schema_id` string, required

## Response `200`

Schema deleted successfully

- SchemaDeleteResponse — Response model for schema deletion.
  - `message` string, required — Deletion status message

## Other responses

- `401` — Unauthorized
- `403` — Insufficient permissions
- `404` — Schema not found
- `422` — Validation Error
- `500` — Internal server error

## Changes

- **2026-06-11** `f29d29d1ad16` — 1 breaking, 1 info
  - the response's body type changed from no type to `object` for status `200`
  - added the required property `message` to the response with the `200` status
- **2026-06-11** `22d84aa060d6` — 2 breaking
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `message` from the response with the `200` status
- **2026-06-10** `02daa1da4e82` — 1 breaking, 1 info
  - the response's body type changed from no type to `object` for status `200`
  - added the required property `message` to the response with the `200` status
- **2026-03-13** `0e4854909d2a` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2025-11-07** `14ff13755871` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/papr-ai/apis/papr-memory-api/changes/v1/schemas/:schema_id/delete.md)

---

[API](https://skmtc.dev/papr-ai/apis/papr-memory-api.md) · [All operations](https://skmtc.dev/papr-ai/apis/papr-memory-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/papr-ai/papr-memory-api/revisions/b553be9aad37/schema)