LLM-readable documentation index
ApiV3GeneratedKnowledge Graph

Retrieve the Knowledge Graph

Hand off to an LLM
GET
/v3/knowledge-graph
x-api-key<token>

Authenticate using API Key in request header

In: header

Query Parameters

limit?integer

Maximum number of edges per page (default 50, max 200).

Formatint32
cursor?string

Cursor: return edges whose KSUID sorts after this value.

type?array<>

Restrict to entities of these types. An edge is returned only when BOTH of its endpoints survive the type filter.

since?string

Only edges created at/after this RFC 3339 timestamp.

Formatdate-time
search?string

Case-insensitive substring match on canonical names. Both endpoints of an edge must match for the edge (and its nodes) to be returned.

bucket?string

Optional bucket public ID (bkt_...) to scope the read to one bucket. Omit for the unscoped (all account+environment) view.

Response Body

application/json

curl -X GET "https://api.bem.ai/v3/knowledge-graph"
{
  "nodes": [
    {
      "id": "string",
      "canonical": "string",
      "type": "string",
      "mentionCount": 0
    }
  ],
  "edges": [
    {
      "sourceId": "string",
      "targetId": "string",
      "relationType": "string",
      "mentionCount": 0
    }
  ],
  "nextCursor": "string"
}