Warrants

State a reason

from bears on to with this polarity, because of this reason.

support is a reason the target stands. rebut attacks the CLAIM. undercut attacks an EDGE — its to must be a warrant ref, and one aimed anywhere else is written and folds INERT (A5: ingest never validates), which the response says rather than refusing. undermine attacks a PREMISE and discounts the edges leading from it, one hop.

Keep the returned edge id: it is the only handle that can ever withdraw this reason.

An edge is a REASON, with an exact id. Two edges whose prose resembles are two edges and no fold merges them; the fold never reads reason at all, which is why it is required — it is written for the human reading the audit, and nothing else will ever supply it.

There is NO delete. Withdrawing a reason is bottom, an APPEND that leaves the edge, its defeat, and the history of both in the log forever.

An acceptance status is a joint function of TWO logs — the warrant log and the assertion log the verdict oracle reads — so every read carries both cursors. Two answers are comparable only at equal pairs.

contested is in the status vocabulary and CANNOT OCCUR in the current topology: an edge attacks exactly one target, so undercut cycles are closed under their own targets and a support/rebut edge can never be undecided. Do not build a UI state for it.

Requires the coord:write scope. Accepts all three lanes: a session JWT (bounded by the caller's role on this workspace) or an il_* machine credential whose own scope set, workspace set and validity window cover it — both ceilings apply and neither can raise the other, so a credential carrying coord:write is still refused where the role does not permit it.

A credential with no scope record resolves to LEGACY_DEFAULT, which does NOT include coord:write — mint a key with it explicitly (POST /v2/workspaces/{id}/keys).

post/v2/workspaces/{id}/warrants

Request

  • Base URL: https://api.infolang.ai
  • URL: https://api.infolang.ai/v2/workspaces/{id}/warrants
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer

Path parameters

idstring required

Request body

polarity'support' | 'rebut' | 'undercut' | 'undermine' required
reasonstring required
edgestring uuid

Response

The edge, and whether it will fold inert

recordstring required
authority'inference' | 'observation' | 'operator' required
mintedstring nullable
appendedboolean
advisoryunknown
folded_inertboolean
edgestring required

Changes

No recorded changes to this operation across all 1 revision of this API.