Docs

Edges & Graph

Graph expansion is no longer a public search primitive for new integrations.

Use v2 knowledge search

New products should call POST /v2/buckets/{bucket_id}/search. The server owns retrieval expansion, reranking, context packing, citations, and warnings instead of asking clients to manage graph edges directly.

bashcurl -X POST https://api.schift.io/v2/buckets/{bucket_id}/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SCHIFT_API_KEY" \
  -d '{
    "query": "Which policy replaced the old retention rule?",
    "top_k": 8,
    "options": {
      "rerank": {"enabled": true},
      "instructions": {"task": "answer with cited supporting context"}
    }
  }'

Older edge routes may still exist for compatibility or internal experiments, but they should not be used as the default public API surface.