AGagentsky
Memory

Search one platform source: memory, conversations, the trace library, memory notes, files, meeting notes, skills or agents [read]

Changed on

Searches one platform-owned source in the workspace your key is in. Restricted and delegated callers are refused. The consumer app's /api/context/search merges every source (including imports, artifacts and the Help Center) under the same grammar; use it to search everything at once. q is plain words (one case-insensitive substring, one hit per item), "an exact phrase" (case-sensitive, every matching line) or /a regex/ with optional i, s or u flags (every matching line). Nested repetition and backreferences are refused, and a pattern stops at a time budget with partial=true. Each hit carries path (such as skills/review/SKILL.md) and, for a match in the text, its 1-based line. Results are in stable source order, not a relevance ranking. Follow nextCursor until null and inspect partial/coverage before concluding no match exists. Memory entries have no per-entry timestamps, so their coverage reports that time filtering does not apply.

get/context/search

Request

  • Base URL
    https://api.agentsky.dev/v1
  • URL
    https://api.agentsky.dev/v1/context/search
  • Auth
    HTTP bearer

Query parameters

qstring required
scope'memory' | 'sessions' | 'traces' | 'notes' | 'files' | 'meetings' | 'skills' | 'agents' required

The source: traces is the current workspace's trace library (every member's uploaded local agent sessions); notes the workspace's memory-store notes; files and meetings its uploaded files (meetings is the Mac app's meeting notes); skills every file of its skills; agents each agent's name and prompt.

pathstring

Keep only hits under this folder, such as skills/review/ or memory/sales/.

limitinteger
cursorstring

Source continuation returned by this query.

sincestring date-time

Inclusive lower time bound.

untilstring date-time

Exclusive upper time bound; must follow since.

Response

A bounded source page, with continuation and coverage.

nextCursorstring nullable required
coveragestring required
partialboolean

Changes

  • e5e8f0229a99Revision changes
    • breaking

      added subschema #5 subschema #6 subschema #7 subschema #8 subschema #9 subschema #10 to the /// response property oneOf list for the response status

    • warning

      added the new agents enum value to the /// response property for the response status

    • warning

      added the new docs enum value to the /// response property for the response status

    • warning

      added the new files enum value to the /// response property for the response status

    • warning

      added the new meetings enum value to the /// response property for the response status

    • warning

      added the new notes enum value to the /// response property for the response status

    • warning

      added the new skills enum value to the /// response property for the response status

    • warning

      added the new traces enum value to the /// response property for the response status

    • info

      added the new optional query request parameter path

    • info

      added the new enum value agents to the query request parameter scope

    • info

      added the new enum value files to the query request parameter scope

    • info

      added the new enum value meetings to the query request parameter scope

    • info

      added the new enum value notes to the query request parameter scope

    • info

      added the new enum value skills to the query request parameter scope

    • info

      added the new enum value traces to the query request parameter scope

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status