---
title: "What is accepted about one ref, and on what evidence"
method: GET
path: "/v2/workspaces/{id}/warrant-status"
tags: ["Warrants"]
---

# What is accepted about one ref, and on what evidence

`GET /v2/workspaces/{id}/warrant-status`

## Request

- Base URL: `https://api.infolang.ai`
- URL: `https://api.infolang.ai/v2/workspaces/{id}/warrant-status`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

`?target=<space>:<id>` — for example `memory:mem_123` or `assertion:a_9`.

`edges` are the edges BEARING ON this ref (those whose `to` names it). Edges leading FROM it — the case where this memory is a premise supporting something else — are not here; ask `warrant-impact`, or use the per-memory route which does both.

The edges arrive WITHOUT labels, so no per-edge verdict is available and this response groups them by the polarity each states. The headline `status` is the fold's verdict and accounts for every defeat.

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:read` 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:read` 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:read` — mint a key with it explicitly (`POST /v2/workspaces/{id}/keys`).

## Path parameters

- `id` string, required

## Query parameters

- `target` string, required: "<space>:<id>"

## Response `200`

The acceptance status, its edges, and both cursors

- object
  - `target` object
    - `space` 'assertion' | 'memory' | 'source' | 'inquiry' | 'warrant', required
    - `id` string, required
  - `status` 'warranted' | 'defeated' | 'contested' | 'unsupported', required
  - `edges` object[], required
    - `meta` object, required
      - `id` string, required
      - `writer` string, required
      - `authority` 'inference' | 'observation' | 'operator', required
      - `valid_time` string, required
      - `tx_time` string, required
    - `body` union, required
      - object
        - `type` 'edge', required
        - `edge` string, required
        - `from` object, required
          - `space` 'assertion' | 'memory' | 'source' | 'inquiry' | 'warrant', required
          - `id` string, required
        - `to` object, required
          - `space` 'assertion' | 'memory' | 'source' | 'inquiry' | 'warrant', required
          - `id` string, required
        - `polarity` 'support' | 'rebut' | 'undercut' | 'undermine', required
        - `reason` string, required
      - object
        - `type` 'bottom', required
        - `edge` string, required
        - `reason` string, required
  - `cursors` object, required
    - `warrant` string, required
    - `coord` string, required
  - `fold_size` number, required
  - `edges_note` string, required
  - `oracle` object, required
    - `scan_limit` number, required
    - `truncation_detectable` false, required
    - `note` string, required

## Other responses

- `401`: Missing/invalid credential, or `credential_expired` — the credential is outside its `[not_before, expires_at)` window and must be replaced
- `403`: `insufficient_scope` — the credential's own scope set, or the caller's role on this workspace, does not cover the scope this route requires (the missing scope is named in the message). Or `forbidden` — the credential is not scoped to this workspace, or holds no grant on it
- `501`: The warrant verbs are not compiled into this deployment (`kernel-verbs` is off upstream)

---

[API](https://skmtc.dev/infolang/apis/infolang-api.md) · [All operations](https://skmtc.dev/infolang/apis/infolang-api/llms.txt) · [OpenAPI document](https://skmtc.dev/infolang/apis/infolang-api/revisions/d04bf6de72c8?raw)