Skip to content
Dashboard
API Reference

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 ​

HeaderTypeRequiredAllowed value and meaning
AuthorizationstringYesBearer <Mosaic API key>. The key's organization must own the store.

Path parameters ​

ParameterTypeRequiredAllowed value and meaning
store_idUUID stringYesMosaic-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 }
FieldTypePossible values
successbooleanAlways true in a 200 OK response.

Error responses ​

StatusPayloadPossible 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.