---
title: "Create or replace a shared store entry"
method: PUT
path: "/shared-stores/{store_id}/entries/{entry_id}"
tags: ["Shared Stores"]
---

# Create or replace a shared store entry

`PUT /shared-stores/{store_id}/entries/{entry_id}`

## Request

- Base URL: `https://api.mosaic.so`
- URL: `https://api.mosaic.so/shared-stores/{store_id}/entries/{entry_id}`
- Auth: HTTP bearer

Idempotently create or replace an entry's display name and metadata. A store may have at most 10,000 entries. Metadata must be a JSON object no larger than 256 KB.

## Request body

- SharedStoreEntryWrite
  - `display_name` string, required: Human-readable entry label.
  - `metadata` object, nullable: Caller-defined JSON object up to 256,000 UTF-8 bytes. Omitted or null becomes an empty object.

## Response `200`

Entry written

- object
  - `entry` SharedStoreEntry, required
    - `entry_id` string, required: Caller-defined ID, unique within the store.
    - `display_name` string, required: Human-readable entry label.
    - `metadata` object, required: Non-null JSON object containing caller-defined values.
    - `created_at` string, date-time, required: UTC creation timestamp; preserved when an entry is replaced.

## Other responses

- `400`: Entry fields or metadata are invalid
- `401`: Shared Store authentication failed
- `403`: The organization does not have API access
- `404`: The store does not exist or belongs to another organization
- `409`: New IDs would take the store beyond 10,000 entries
- `413`: UTF-8 encoded metadata exceeds 256,000 bytes
- `500`: Entry could not be written

---

[API](https://skmtc.dev/mosaic/apis/mosaic-ai-api.md) - [All operations](https://skmtc.dev/mosaic/apis/mosaic-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mosaic/apis/mosaic-ai-api/revisions/c20e9fc606a4?raw)