REFERENCE
API reference
The Geltre API is intentionally narrow. You provide state; Geltre points to the evidence your next model or program should see.
POST /v1/orient
| Field | Type | Meaning |
|---|---|---|
| task | string | The current objective. |
| state | EvidenceUnit[] | Supplied evidence with stable refs. |
| budget | integer | Maximum evidence units returned. |
| target | string | Current preview: decision. |
EvidenceUnit
{"ref":"context:2","source":"context","text":"target service failed after the latest start attempt"}
Response invariants
- Every returned ref exists in the submitted state.
- Returned evidence does not exceed the requested budget.
- Equal inputs under deterministic model versions produce equal selection output.
- Duplicate input refs are rejected.
Authentication and billing
Use a Geltre API key as a Bearer token. Billable input is metered by the Geltre service and prepaid credit is deducted atomically after a valid selection request.
GET /v1/balance
Returns the prepaid balance for the authenticated developer account.