Skip to Content

Support

Troubleshooting

Fix the most common problems with capturing and recalling memories.

Find what you're seeing in the first column, then follow the fix.

Capturing

What you seeWhy it happensWhat to do
API key is requiredDOCKLEE_API_KEY isn't set where your code runs.Set the variable, or pass api_key (Python) or apiKey (TypeScript).
Dock instance is closedcapture was called after close().Create a new Dock, or close it only when you're done.
Memories never arriveThe process exited before the buffer was sent.Call flush_sync() or close() before exit. See Batching and flush.
422 with missing_destinationThe request named neither a memory space nor a container.Set DOCKLEE_MEMORY_SPACE_ID, or pass memory_space_id.
400 with invalid_memory_space_idThe memory space ID isn't a valid ID.Copy the ID again from DUM.
duplicate_event in errorsThe same content arrived within 60 seconds.Expected for retries. To record a repeat, use a different dedup_key.
memory_space_not_authorized in errorsThe key can't write to this memory space.Use a key with write or both, scoped to the space.
403The key's capability, runtimes, or scope don't allow the write.Check the key in API Keys. See API keys.
429You've hit your plan's write rate limit.Retry after the time in Retry-After. The SDK retries for you.

Recalling

What you seeWhy it happensWhat to do
memory_space_id is required for recall()No space ID was given.Set DOCKLEE_MEMORY_SPACE_ID, or pass memory_space_id.
Recall returns [] in a space with memoriesThe space is multi-user, and no end_user was passed.Pass the same end_user you captured with. See End users.
An old value comes backThe update was edited into the old memory, or never captured.Capture the change as a new memory. See Contradictions and updates.
Both conflicting facts come backDocklee couldn't tell which is right.Settle it in the Review tab. See Review and correction.
A memory disappearedIt expired under the space's retention.Extend it, or change the space's retention. See Retention.
429You've hit your plan's read rate limit.Retry after the time in Retry-After. The SDK retries for you.

Still stuck

See the FAQs, or contact Docklee support with the batch_id from the capture response and the time of the request.

Next steps

Back to building. These pages cover the calls you'll use most.

On this page