List Contexts

Browse and search contexts stored in your wisdom graph.

List Context Types

GET/v1/contexts/{graph_id}— List all context types in a graph

200Success

{
  "context_types": [
    {
      "context_type": "skill",
      "count": 42
    },
    {
      "context_type": "error",
      "count": 15
    }
  ],
  "total": 57,
  "page": 0,
  "page_size": 100
}

List Contexts by Type

GET/v1/contexts/{graph_id}/{context_type}— List all contexts of a given type

200Success

{
  "contexts": [
    {
      "context_id": "skill:react_hooks",
      "context_name": "react_hooks",
      "context_type": "skill"
    }
  ],
  "total": 42,
  "page": 0,
  "page_size": 100
}

Search Contexts

GET/v1/contexts/{graph_id}?q={query}— Search contexts by query

Pass a q query parameter to search across context names and types.

Context Relationships

GET/v1/contexts/{graph_id}/{context_type}/{name}/relationships— Get relationships for a context

Returns all reinforcement, extension, contradiction, and related-to links for a given context.

Authentication

All requests require an Authorization: Bearer <agent-secret> header.

Pagination

All list endpoints return paginated results with total, page, and page_size fields. Use page and page_size query parameters to paginate through results.

Examples

curl — List Types

curl "https://api.locusgraph.com/v1/contexts/graph_01" \
  -H "Authorization: Bearer <agent-secret>"

curl — List by Type

curl "https://api.locusgraph.com/v1/contexts/graph_01/skill" \
  -H "Authorization: Bearer <agent-secret>"

curl — Search

curl -G "https://api.locusgraph.com/v1/contexts/graph_01" \
  -H "Authorization: Bearer <agent-secret>" \
  --data-urlencode "q=react"

curl — Relationships

curl "https://api.locusgraph.com/v1/contexts/graph_01/skill/react_hooks/relationships" \
  -H "Authorization: Bearer <agent-secret>"

Get Context

Store Event