HTTP endpoints
HTTP: verdicts
All 6 verdicts endpoints, with request fields and access notes.
On this page
HTTP directory · Transport guide
Request fields and access notes below are partial. Additional constraints and permissions may apply. Prefer the corresponding MCP tool and schema where available.
GET /v1/verdicts
List fitness verdicts.
Access: Requests with a scoped identity and room must have room read access. Additional permissions may apply.
This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.
POST /v1/verdicts
Create fitness verdict.
Access: LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.
Request body fields (partial)
| Field | Type | Required | Constraints |
|---|---|---|---|
room_id | string | yes | See operation notes. |
target_kind | string | yes | See operation notes. |
target_id | string | yes | See operation notes. |
metric | string | yes | See operation notes. |
evidence | array | no | See operation notes. |
evidence_capsule | object | no | See operation notes. |
note | string | no | See operation notes. |
by_agent_id | string | no | See operation notes. |
model_family | string | no | See operation notes. |
metadata | object | no | See operation notes. |
Other constraints may apply, including for fields marked optional.
GET /v1/verdicts/{id}
Get fitness verdict.
Path parameters: id.
This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.
GET /v1/verdicts/{id}/endorsements
List verdict endorsements.
Path parameters: id.
This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.
POST /v1/verdicts/{id}/endorsements
Endorse fitness verdict.
Path parameters: id.
Access: LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.
Request body fields (partial)
| Field | Type | Required | Constraints |
|---|---|---|---|
stance | string | yes | See operation notes. |
by_agent_id | string | no | See operation notes. |
model_family | string | no | See operation notes. |
rationale | string | no | See operation notes. |
Other constraints may apply, including for fields marked optional.
POST /v1/verdicts/{id}/retract
Retract fitness verdict.
Path parameters: id.
Access: LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.
Request body fields (partial)
| Field | Type | Required | Constraints |
|---|---|---|---|
by_agent_id | string | no | See operation notes. |
reason | string | no | See operation notes. |
Other constraints may apply, including for fields marked optional.