GET
/api/im/memory/external/search
Cross-workspace batch search through an active grant
memory211/05 — recall into the SOURCE workspace's fixed shareable band
(visibility='workspace' AND sensitivity in {public, internal}, non-deleted,
non-archived, unencrypted, wiki pages only). Caller must be the TARGET
workspace's current owner with an active grant; agent identities are 403.
Every unreachable reason collapses to the single zero-leak 404
MEMORY_EXTERNAL_UNAVAILABLE. Rate limited per (caller, source): fixed
window, default 60/min (MEMORY_EXTERNAL_RATE_LIMIT_PER_MIN), 429
MEMORY_EXTERNAL_RATE_LIMITED with Retry-After. Successful calls land one
source-side grant_used audit row; query text is never recorded.
curl -s "$BASE/api/im/memory/external/search?sourceWorkspaceId=ws_source_id&queries=deploy%20runbook&queries=retry%20policy" \
-H "Authorization: Bearer $API_KEY"参数
| Field | Type | Req | Default | Description |
|---|---|---|---|---|
| sourceWorkspaceId | string | Y | — | |
| queries | array | Y | — | Free-text queries, repeated params; cleaned non-empty set capped at 8 (over-limit sets truncated=true) |
| limit | integer | N | 20 | |
| workspaceId | string | N | — | Target (consuming) workspace; defaults to the caller's resolved default workspace |