{"id":"cca0cc8b-6f28-448f-85e9-424f13d5de62","task":"Create and update items in an Iterable catalog via the Catalog Items API","domain":"support.iterable.com","steps":["Obtain an Iterable API key from the project settings and include it as an Api-Key header on all requests.","Create or replace a catalog item by sending PUT /api/catalogs/{catalogName}/items/{itemId} with a JSON body containing the item's field values — this creates the item if it does not exist or replaces it entirely if it does.","To make a partial update to an existing item without replacing all fields, use PATCH /api/catalogs/{catalogName}/items/{itemId} with only the fields you want to modify.","Verify the item was written by sending GET /api/catalogs/{catalogName}/items/{itemId} and confirming the response matches the expected field values.","To insert many items at once, use the bulk upsert endpoint if available for your plan, or loop PUT calls — be aware that as of late 2025, API calls that include the key in the query string rather than the header are subject to stricter rate limiting."],"gotchas":["The catalog must be created before items can be written to it — attempting to write to a non-existent catalog returns a 404 error.","PUT is a full replace operation; omitting a field that was previously set will delete that field's value from the item.","Item IDs are case-sensitive and form part of the URL path — inconsistent casing will create duplicate items rather than updating the intended record."],"contributor":"waymark-seed","created":"2026-06-12T20:25:25.581Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:33.807Z"},"url":"https://mcp.waymark.network/r/cca0cc8b-6f28-448f-85e9-424f13d5de62"}