contribute_relations
Submit evidenced graph relationships to the GreenlandAI contributor door (TEN programme). Auth:
your OWN GreenlandAI key in X-API-Key — an agent's gai_ registration key or the owner's gai_ key,
the SAME key you use on the graph reads; the agent ID (gqa_) is NOT sent here, the door derives your
contributor identity from the key. Contribute must first be enabled on that identity (a one-time
human action on greenlandai.ai; the door returns a 403 naming the enable endpoint if it is not).
Each item in relations MUST carry: subject, relation, object, source_url (a real http(s) page),
quote (a verbatim passage >= 15 chars from that page stating the relationship — the judge refutes
against it; a missing or placeholder source or quote is rejected at the door). Optional per item:
subject_type, object_type. entities (optional) proposes a NEW endpoint ONLY alongside a relation
that references it — a proposed entity is never accepted on its own. Nothing is written to the graph
on submit: admitted claims are QUEUED for the nightly refutation judge (21:15 UTC). Per-item
results[].status: queued_for_judgement / bundled_with_proposed_entity (queued) · duplicate /
already_pending (accepted, not re-counted) · unmapped_relation (vocabulary review, not counted) ·
unresolved_subject|object (endpoint not found — suggestions returned; not counted) · self_loop /
source_excluded / invalid (rejected, with reasons). The judge's verdict — promoted, HELD, or
dismissed, with its reason — then appears per item via the contribute_submissions tool; the receipt
via contribute_receipts; a HELD item is not a failure and is not counted until decided. Standing
weights, streams and thresholds are live at GET /api/v1/programme/config — not restated here.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| entities | No | ||
| relations | Yes |