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
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
{ "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.