IonWarpCollections
Reviewers
The reviewers available to run on your repo.
Base path /api/v1/reviewers on https://ionwarp.com. Authenticate with Authorization: Bearer $DASH_API_KEY and name the project with the Project-ID header. Writes are validated in declared mode; an operation this resource does not declare answers 405 operation_not_supported.
Create a reviewer
POST /api/v1/reviewers
curl -X POST "https://ionwarp.com/api/v1/reviewers" \
-H "Authorization: Bearer $DASH_API_KEY" \
-H "Project-ID: pr_acme" \
-H "Content-Type: application/json" \
-d '{"enabled":true}'Create a new reviewerdata_set {
"collection": "agents",
"object_id": "learning-tests-run-under-bun",
"data": {
"enabled": true
}
}Returns the reviewer object.
{
"object": "reviewer",
"id": "obj_123",
"name": "name",
"kind": "kind",
"category": "category",
"description": "description",
"status": "enabled",
"enabled": true,
"capabilities": {
"autofix": true,
"browser": true,
"mcp": true
},
"created_at": "2026-07-25T12:00:00.000Z",
"updated_at": "2026-07-25T12:00:00.000Z"
}Parameters
| Field | Type | Required | Description |
|---|---|---|---|
enabled | boolean | no | Whether this reviewer takes part in reviews. Update this flag to choose the project's default lineup. |
Update a reviewer
PATCH /api/v1/reviewers/learning-tests-run-under-bun
curl -X PATCH "https://ionwarp.com/api/v1/reviewers/learning-tests-run-under-bun" \
-H "Authorization: Bearer $DASH_API_KEY" \
-H "Project-ID: pr_acme" \
-H "Content-Type: application/json" \
-d '{"enabled":true}'Update the reviewer {id}data_set {
"collection": "agents",
"object_id": "learning-tests-run-under-bun",
"data": {
"enabled": true
}
}Returns the reviewer object.
{
"object": "reviewer",
"id": "obj_123",
"name": "name",
"kind": "kind",
"category": "category",
"description": "description",
"status": "enabled",
"enabled": true,
"capabilities": {
"autofix": true,
"browser": true,
"mcp": true
},
"created_at": "2026-07-25T12:00:00.000Z",
"updated_at": "2026-07-25T12:00:00.000Z"
}Parameters
| Field | Type | Required | Description |
|---|---|---|---|
enabled | boolean | no | Whether this reviewer takes part in reviews. Update this flag to choose the project's default lineup. |
Append an event to a reviewer
POST /api/v1/reviewers/{id}/events
curl -X POST "https://ionwarp.com/api/v1/reviewers/learning-tests-run-under-bun/events" \
-H "Authorization: Bearer $DASH_API_KEY" \
-H "Project-ID: pr_acme" \
-H "Content-Type: application/json" \
-d '{"event":"Noted by the operator","context":{"source":"api"}}'Add a note to the reviewer {id}data_event {
"collection": "agents",
"object_id": "learning-tests-run-under-bun",
"event": "Noted by the operator"
}Returns the appended event object.
{
"object": "event",
"id": "evt_123",
"event": "Noted by the operator"
}Parameters
| Field | Type | Required | Description |
|---|---|---|---|
event | string | yes | The human-readable timeline entry. |
context | object | no | Provenance — source, integration, worker_run_id, … |
What comes back (read-only)
Every reviewer carries the envelope below. The fields under it are computed or stamped by the platform — they are returned, never sent.
| Field | Type | Description |
|---|---|---|
object | string | Always reviewer. |
id | string | Stable object id. Also accepted in place of slug on any path. |
slug | string | URL-safe name, unique within the collection. |
created_at | string | ISO-8601 timestamp of the first write. |
updated_at | string | ISO-8601 timestamp of the most recent write. The cursor sorts on this. |
name | string | Display name of the reviewer. |
kind | string | What the reviewer is: review for a reviewer that runs on a PR, conductor for IonWarp itself. |
category | string | Catalog grouping taken from the reviewer skill's frontmatter (code, product, docs, marketing). Rows that do not carry one are grouped by kind instead. |
skill_id | string | Id of the skill this reviewer runs. |
description | string | What this reviewer reviews, in one line. |
status | string | Whether the reviewer is switched on for this repo, and whether it is mid-review right now. |
capabilities | object | What this reviewer is able to do during a review. |
capabilities.autofix | boolean | Whether this reviewer can push a fix as well as report a finding. |
capabilities.browser | boolean | Whether this reviewer drives a real browser against a preview deployment. |
capabilities.mcp | boolean | Whether this reviewer can call MCP tools during a review. |
Errors
Failures use { error: { type, code, message, param } }. The full code table is generated at Error Codes.
