Skip to main content
POST
Build Sip

Authorizations

Authorization
string
header
required

EDN API key presented as 'Bearer ' in the Authorization header. Create and manage keys from the Console.

Body

application/json
include_global
boolean
default:false
project_id
string | null
query
string | null
session_id
string | null

Response

Successful Response

records_used
integer
required
sip
string
required
user_id
string
required
abstain
boolean
default:false
citations
SipCitation · object[]
grounded
boolean
default:false
sip_sections
SipSections · object

The structured five-section SIP (Fix 3), additive to the flat sip string.

Sections mirror services/sip/builder.build_sip:

  • identity: USER_STATED / USER_CONFIRMED records
  • active_context: remaining FACTUAL records (DOCUMENT_VERIFIED, AI_INFERRED marked inference_only, ROUND)
  • preferences: PREFERENCE-type records
  • calibration_notes: empty passthrough owned by Track B (UCE); never fabricated here
  • uncertain_facts: AI_GENERATED records, marked uncertain

Retrieval gates the live candidate set to FACTUAL + SIP_ELIGIBLE, so on the live path preferences and uncertain_facts are empty by construction. This is additive: existing consumers keep reading the flat sip string and may ignore this field entirely.