Get an Entry
Get one shared-store entry.
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 containing the requested entry. |
entry_id | string | Yes | Exact non-empty caller-defined entry ID within that store. URL-encode reserved path characters. |
This endpoint has no query parameters or JSON request body.
bash
curl \
"https://api.mosaic.so/shared-stores/11111111-1111-4111-8111-111111111111/entries/0689B" \
-H "Authorization: Bearer mk_your_api_key"Response
200 OK
json
{
"entry": {
"entry_id": "0689B",
"display_name": "Jordan Lee",
"metadata": { "age": 31, "market": "Austin" },
"created_at": "2026-08-03T20:00:00Z"
}
}| Field | Type | Meaning and possible values |
|---|---|---|
entry | object | The complete store-scoped entry matching {entry_id}. The object always contains every field listed below. |
entry.entry_id | string | Caller-defined identifier, unique within the store. It exactly matches the stored ID addressed by {entry_id}. |
entry.display_name | string | Current human-readable entry label. Always non-empty. |
entry.metadata | JSON object | Caller-controlled structured data. Always an object and never null; may be {} and may contain nested objects, arrays, strings, numbers, booleans, or null values. Maximum encoded size is 256 KB. |
entry.created_at | ISO 8601 string | UTC timestamp when this entry ID was first created. Replacing the entry preserves this value. |
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 store does not exist or belongs to another organization. |
404 Not Found | { "error": "Shared store entry not found" } | The entry ID does not exist in the store. |
500 Internal Server Error | { "error": "Failed to get shared store entry" } | The entry could not be read. |