Inquiries

Give up on a question, with a reason

Authority-floored (IR5): top authority, OR a writer who opened the question. "You may abandon your own question; killing another's requires rank." A below-floor abandon is WRITTEN and folds INERT — visible in lineage forever, with no effect on the agenda (D4).

Unlike the correspondence verbs, the inquiry verbs do NOT report folded_inert: the floor depends on who opened the question, which the verb layer would have to fold to know. So this route RE-READS the lineage and reports effective and the resulting status, rather than returning a 201 that a caller would read as a retirement. That costs one extra upstream call, spent on the one question a caller cannot otherwise answer.

Refining a question is not answering it, and similarity cannot retire a question.

narrow marks the parent narrowed, which is a LIVE status: the parent STAYS on the agenda (IR2). split leaves the parent superseded with recorded lineage, never answered (IR3) — and never split, a status in the wire vocabulary that the fold never produces.

An answer must NAME an assertion (IR4), and a memory NEVER answers a question by arriving on its subject key. The match would be exact, which is exactly why it looks defensible; the rule it breaks is IR4. Pass answers_inquiry on a remember to state one.

An agenda ROW is an equivalence CLASS, not a question (IR6): two questions joined by same_as are ONE row with two members, and outstanding counts ROWS. same_as groups the VIEW and merges no identity, no lineage and no history.

abandon and same_as are authority-floored; a below-floor record is written and folds INERT, never rejected (D4). There is NO delete: reopening an abandonment is an append that cites ONE specific abandon record.

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}/inquiries/{inquiry}/abandon

Request

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

Path parameters

idstring required
inquirystring required

Request body

reasonstring required
recordstring uuid

Response

The record, and what the FOLD did with it

inquirystring required
reasonstring required
recordstring required
authoritystring required
appendedboolean required
effectiveboolean nullable required
statusstring nullable required
floor_notestring required

Changes

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