> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mosaic.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a Shared Store

> Delete a shared store and all of its entries.

This page documents its request, success response, and error response fields in full.

## Request

### Headers

| Header          | Type   | Required | Allowed value and meaning                                             |
| --------------- | ------ | -------- | --------------------------------------------------------------------- |
| `Authorization` | string | Yes      | `Bearer <Mosaic API key>`. The key's organization must own the store. |

### Path parameters

| Parameter  | Type        | Required | Allowed value and meaning                                                                               |
| ---------- | ----------- | -------- | ------------------------------------------------------------------------------------------------------- |
| `store_id` | UUID string | Yes      | Mosaic-generated `store.id` of the store to delete. Deleting it also deletes all entries in that store. |

This endpoint has no query parameters or JSON request body.

```bash theme={null}
curl -X DELETE \
  "https://api.mosaic.so/shared-stores/11111111-1111-4111-8111-111111111111" \
  -H "Authorization: Bearer mk_your_api_key"
```

## Response

### `200 OK`

```json theme={null}
{ "success": true }
```

| Field     | Type    | Possible values                       |
| --------- | ------- | ------------------------------------- |
| `success` | boolean | Always `true` in a `200 OK` response. |

## Error responses

| Status                      | Payload                                        | Possible value                                                                                                                              |
| --------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `401 Unauthorized`          | `{ "detail": string }`                         | `detail` is exactly `Authorization header must start with Bearer`, `invalid_api_key`, or `API key must be associated with an organization`. |
| `403 Forbidden`             | `{ "detail": "api_access_required" }`          | API access is unavailable for the organization.                                                                                             |
| `404 Not Found`             | `{ "error": "Shared store not found" }`        | The ID does not exist or belongs to another organization.                                                                                   |
| `500 Internal Server Error` | `{ "error": "Failed to delete shared store" }` | The store could not be deleted.                                                                                                             |

<Warning>This permanently deletes the store and its entries.</Warning>
