Skip to content
Dashboard
API Reference

List Shared Stores ​

List the shared stores in your organization.

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 determines the organization whose stores are returned.

This endpoint has no path parameters, query parameters, or JSON request body.

bash
curl "https://api.mosaic.so/shared-stores" \
  -H "Authorization: Bearer mk_your_api_key"

Response ​

200 OK ​

json
{
  "stores": [
    {
      "id": "11111111-1111-4111-8111-111111111111",
      "name": "Talent",
      "source_type": "manual",
      "created_at": "2026-08-03T20:00:00Z",
      "updated_at": "2026-08-03T20:00:00Z"
    }
  ]
}
FieldTypeMeaning and possible values
storesarrayEvery shared store visible to the API key's organization. Empty array or up to 10 items, sorted by name ascending.
stores[]objectOne shared store. The object always contains every field listed below.
stores[].idUUID stringMosaic-generated permanent identifier for the store. Pass this exact value as {store_id} in store and entry endpoint paths.
stores[].namestringCurrent human-readable store name. Always non-empty.
stores[].source_typestringSource label supplied when the store was created. Defaults to manual, but may be any non-empty string; this is not an enum.
stores[].created_atISO 8601 stringUTC timestamp when the store was created.
stores[].updated_atISO 8601 stringUTC timestamp when the store was last changed. Equals created_at until the store is updated.

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.
500 Internal Server Error{ "error": "Failed to list shared stores" }The stores could not be read.