---
title: "Archive shared or extension model"
method: DELETE
path: "/v1/models/{modelId}"
tags: ["Models"]
---

# Archive shared or extension model

`DELETE /v1/models/{modelId}`

## Request

- Base URL: `https://blobsrus.omniapp.co/api`
- URL: `https://blobsrus.omniapp.co/api/v1/models/{modelId}`
- Auth: HTTP bearer

<Note>
  **Connection Admin** permissions are required to use this endpoint.
</Note>

Archive a shared or shared extension model, including all content and child extension models built on the target. For shared models, and shared extension models in the **Develop independently** branch workflow that own a Git repository, the model's Git configuration is also removed.

This endpoint performs a soft delete - the model is recoverable from the [trash](/content/archive-restore). Restoring the model does not automatically restore its content, which must be restored separately.

Only `SHARED` and `SHARED_EXTENSION` models can be deleted with this endpoint. To delete a branch model, use the [Delete branch API](/api/models/delete-branch).

## Path parameters

- `modelId` string, uuid, required

## Response `200`

Model moved to trash successfully

- SuccessResponse
  - `success` boolean

## Other responses

- `400`: Bad Request Possible error messages: - `Bad Request: Cannot delete models of this kind` — returned for model kinds other than `SHARED` and `SHARED_EXTENSION`. To delete a branch model, use the [Delete branch API](/api/models/delete-branch).
- `403`: Forbidden - Insufficient permissions
- `404`: Not Found Possible error messages: - `Model not found` - `Model already deleted`
- `429`: Too Many Requests - Rate limit exceeded (60 requests/minute)

## Changes

- **2026-11-03** `43290040f88f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/omni/apis/omni-api/changes/v1/models/:modelId/delete.md)

---

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