How It Works
Before any MCP call, establish context once per session via the workspace readiness gate:
../catalyst-basics/references/preflight.md. It resolves and reconciles the org/project soCatalystbyZoho_List_All_Segmentstargets the right project.
- Get Segment ID — Use MCP (
CatalystbyZoho_List_All_Segments) if available; otherwise retrieve it from the console or.catalystrc. - Load
references/cache-basics.md— for SDK operations, TTL limits (48 hr max), and thesegment.delete()/segment.update()gotchas. - String values only — All cache values are strings. Always
JSON.stringifybeforeputandJSON.parseafterget. - TTL behavior —
segment.update(key, value)without an expiry argument resets the TTL to 48 hours (the max), not the key's original TTL. Always pass the TTL explicitly (in hours) to preserve it:segment.update(key, value, ttlHours).segment.delete()returnsnull(not an error) if the key is missing.
Triggers
Use this skill for: "Cache", "cache segment", "cache key", "cache value", "TTL", "in-memory store", segment.get, segment.put, segment.delete, "session data", "temporary data Catalyst", "cache vs Data Store", or "48-hour cache".




