Skip to content
Dashboard
API Reference

Update a Shared Store ​

Rename a shared store.

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.
Content-TypestringYesapplication/json.

Path parameters ​

ParameterTypeRequiredAllowed value and meaning
store_idUUID stringYesMosaic-generated store.id of the store to rename. The store must belong to the API key's organization.

This endpoint has no query parameters.

bash
curl -X PATCH \
  "https://api.mosaic.so/shared-stores/11111111-1111-4111-8111-111111111111" \
  -H "Authorization: Bearer mk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name":"Creators"}'

JSON body ​

FieldTypeRequiredPossible values
namestringYesAny non-empty display name after surrounding whitespace is removed.

Response ​

200 OK ​

json
{
  "store": {
    "id": "11111111-1111-4111-8111-111111111111",
    "name": "Creators",
    "source_type": "manual",
    "created_at": "2026-08-03T20:00:00Z",
    "updated_at": "2026-08-04T18:30:00Z"
  }
}
FieldTypeMeaning and possible values
storeobjectThe complete shared store after the update. The object always contains every field listed below.
store.idUUID stringPermanent Mosaic-generated store identifier. Updating a store never changes it.
store.namestringNew trimmed name accepted from the request. Always non-empty.
store.source_typestringExisting source label. This endpoint does not change it. May be any non-empty string; this is not an enum.
store.created_atISO 8601 stringUTC creation timestamp. Updating a store does not change it.
store.updated_atISO 8601 stringUTC timestamp of this latest store update.

Error responses ​

StatusPayloadPossible value
400 Bad Request{ "error": "name is required" }name is missing, empty, or only whitespace.
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 rename shared store" }The store could not be updated.