model-check-batches
Review selected model checks
Read-only plan for 1–20 explicitly selected account-route revisions, preserving selection across snapshot cursor pages. Return all blockers and exact separate per-check provider maxima and ordinary Millwork fees. No quota, debit or inference occurs.
POST
/
v1
/
model-check-batches
/
plan
Review selected model checks
curl --request POST \
--url https://api.getmillwork.dev/v1/model-check-batches/plan \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"binding_revision": 2,
"connection_id": "<string>",
"filter": {
"connection_id": "<string>",
"include_tested": true,
"limit": 100,
"model_group_key": "<string>",
"publisher_id": "<string>",
"q": "<string>",
"source_id": "<string>"
},
"selected": [
{
"arm_id": "<string>",
"authority_id": "<string>",
"item_id": "<string>",
"observation_revision": "<string>",
"route_id": "<string>",
"snapshot_id": "<string>"
}
],
"snapshot_digest": "<string>",
"task": {
"objective": "<string>"
}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
binding_revision: 2,
connection_id: '<string>',
filter: {
connection_id: '<string>',
include_tested: true,
limit: 100,
model_group_key: '<string>',
publisher_id: '<string>',
q: '<string>',
source_id: '<string>'
},
selected: [
{
arm_id: '<string>',
authority_id: '<string>',
item_id: '<string>',
observation_revision: '<string>',
route_id: '<string>',
snapshot_id: '<string>'
}
],
snapshot_digest: '<string>',
task: {objective: '<string>'}
})
};
fetch('https://api.getmillwork.dev/v1/model-check-batches/plan', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"confirmation_expires_at": "<string>",
"counts": {
"approved_real_checks": 4503599627370495,
"blocked": 4503599627370495,
"eligible": 4503599627370495,
"selected": 4503599627370495
},
"expires_at": "<string>",
"items": [
{
"blockers": [
{
"action": "<string>",
"actor": "<string>",
"code": "access_unverified",
"evidence_refs": [
"<string>"
],
"message": "<string>"
}
],
"execution": {
"byok_inventory": {
"authority_id": "<string>",
"original_inputs": {
"item_id": "<string>",
"observation_revision": "<string>",
"purpose": "add",
"route_id": "<string>",
"authority_id": "<string>",
"task": {
"objective": "<string>"
},
"task_envelope": {
"data_classes": [
"public"
],
"max_input_tokens": 2,
"max_output_tokens": 2,
"max_runtime_s": 2,
"max_reasoning_tokens": 2
}
},
"plan_digest": "<string>",
"plan_token": "<string>",
"price_approval_sha256": "<string>",
"provider_usage_budget_usd": 1
},
"mode": "live",
"policy": {
"budget": {
"max_cost_usd": 123,
"max_runtime_s": 2
},
"data_classes": [
"public"
],
"on_eval": [
"gate"
]
},
"routing": {
"required_arm_id": "<string>"
},
"task": {
"objective": "<string>"
}
},
"plan": {
"binding_revision": 1,
"bound": {
"assumptions": [
"<string>"
],
"input_volume_tokens": 1,
"meters": [
{
"maximum_microusd": 1,
"maximum_volume": 1,
"meter": "<string>",
"rate_usd": "<string>"
}
],
"output_volume_tokens": 1,
"provider_maximum_microusd": 1,
"rate_digest": "<string>",
"source_contract_revision": "<string>",
"anthropic_evidence": {
"evidence_refs": [
"<string>"
],
"expires_at": "<string>",
"input_usd_per_token": "<string>",
"output_usd_per_token": "<string>",
"proof_digest": "<string>",
"request_usd": "<string>",
"resolved_model_ids": [
"<string>"
],
"version": "anthropic.messages/v1"
},
"class_evidence": {
"evidence_refs": [
"<string>"
],
"expected_provider": "<string>",
"expires_at": "<string>",
"meter_limits": [
{
"maximum_volume": 1,
"meter": "<string>",
"usage_field": "prompt_tokens"
}
],
"partitions": [
{
"maximum_volume": 1,
"partition": "<string>",
"usage_fields": [
"<string>"
]
}
],
"proof_digest": "<string>",
"reasoning_maximum_tokens": 1,
"reasoning_mode": "disabled",
"resolved_model_ids": [
"<string>"
],
"revision": "<string>",
"version": "openrouter.classes/v1"
}
},
"confirmation_expires_at": "<string>",
"connection_id": "<string>",
"evaluated_at": "<string>",
"invocation_id": "<string>",
"item_id": "<string>",
"observation_revision": "<string>",
"permission_expires_at": "<string>",
"plan_digest": "<string>",
"plan_token": "<string>",
"prepared_request": {
"max_tokens": 1,
"model": "<string>",
"provider": {
"allow_fallbacks": false,
"data_collection": "deny",
"max_price": {},
"only": [
"<string>"
],
"order": [
"<string>"
],
"require_parameters": true
},
"stream": false,
"usage": {
"include": true
},
"reasoning": {
"effort": "none"
}
},
"purpose": "add",
"readiness": {
"blockers": [
{
"action": "<string>",
"actor": "<string>",
"code": "access_unverified",
"evidence_refs": [
"<string>"
],
"message": "<string>"
}
],
"disposition": "ready",
"evaluated_at": "<string>",
"planner_version": "<string>",
"policy_revision": 1
},
"route_id": "<string>",
"source_id": "<string>",
"task_envelope": {
"data_classes": [
"public"
],
"max_input_tokens": 2,
"max_output_tokens": 2,
"max_runtime_s": 2,
"max_reasoning_tokens": 2
},
"testing": {
"evidence_ref": "<string>",
"last_tested_at": "<string>",
"state": "recorded"
}
},
"quote": {
"authority_id": "<string>",
"bound": {
"assumptions": [
"<string>"
],
"input_volume_tokens": 1,
"meters": [
{
"maximum_microusd": 1,
"maximum_volume": 1,
"meter": "<string>",
"rate_usd": "<string>"
}
],
"output_volume_tokens": 1,
"provider_maximum_microusd": 1,
"rate_digest": "<string>",
"source_contract_revision": "<string>",
"anthropic_evidence": {
"evidence_refs": [
"<string>"
],
"expires_at": "<string>",
"input_usd_per_token": "<string>",
"output_usd_per_token": "<string>",
"proof_digest": "<string>",
"request_usd": "<string>",
"resolved_model_ids": [
"<string>"
],
"version": "anthropic.messages/v1"
},
"class_evidence": {
"evidence_refs": [
"<string>"
],
"expected_provider": "<string>",
"expires_at": "<string>",
"meter_limits": [
{
"maximum_volume": 1,
"meter": "<string>",
"usage_field": "prompt_tokens"
}
],
"partitions": [
{
"maximum_volume": 1,
"partition": "<string>",
"usage_fields": [
"<string>"
]
}
],
"proof_digest": "<string>",
"reasoning_maximum_tokens": 1,
"reasoning_mode": "disabled",
"resolved_model_ids": [
"<string>"
],
"revision": "<string>",
"version": "openrouter.classes/v1"
}
},
"expires_at": "<string>",
"maximum_combined_usd": 123,
"millwork_fee_usd": 123,
"model_deployment_id": "<string>",
"plan_digest": "<string>",
"price_approval_sha256": "<string>",
"provider_invoice_authoritative": true,
"provider_maximum_usd": 123,
"provider_usage_budget_usd": 123,
"schema_version": "byok-inventory-quote/v1"
},
"selection": {
"arm_id": "<string>",
"authority_id": "<string>",
"item_id": "<string>",
"observation_revision": "<string>",
"route_id": "<string>",
"snapshot_id": "<string>"
}
}
],
"limits": {
"attempts": 1,
"in_flight": 1,
"items": 20
},
"millwork_maximum_cents": 4503599627370495,
"ordinary_fee_cents": 4503599627370495,
"plan_digest": "<string>",
"plan_token": "<string>",
"provider_invoice_authoritative": true,
"provider_maximum_microusd": 4503599627370495,
"request": {
"binding_revision": 2,
"connection_id": "<string>",
"filter": {
"access_lane": "byok",
"connection_id": "<string>",
"include_tested": true,
"limit": 100,
"model_group_key": "<string>",
"publisher_id": "<string>",
"q": "<string>",
"readiness": "ready",
"source_id": "<string>",
"view": "routes"
},
"selected": [
{
"arm_id": "<string>",
"authority_id": "<string>",
"item_id": "<string>",
"observation_revision": "<string>",
"route_id": "<string>",
"snapshot_id": "<string>"
}
],
"snapshot_digest": "<string>",
"task": {
"objective": "<string>"
},
"batch_id": "<string>",
"expected_revision": 2
},
"version": "byok-selected-checks/v1"
}{
"instance": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": 123,
"title": "<string>",
"type": "<string>",
"blockers": [
{
"action": "<string>",
"actor": "<string>",
"code": "access_unverified",
"evidence_refs": [
"<string>"
],
"message": "<string>"
}
],
"current_offer": {
"content_markdown": "<string>",
"display_label": "<string>",
"document_id": "<string>",
"offer_id": "<string>",
"published_url": "<string>",
"source_sha256": "<string>",
"title": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"version_id": "<string>"
},
"current_organization": {
"legal_entity_name": "<string>",
"profile_revision": 2
},
"detail": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
],
"next_actions": [
{
"action": "<string>",
"actor": "<string>"
}
],
"reason": "agreement_terminated",
"reason_code": "access_unverified",
"retry_after_s": 123
}{
"instance": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": 123,
"title": "<string>",
"type": "<string>",
"blockers": [
{
"action": "<string>",
"actor": "<string>",
"code": "access_unverified",
"evidence_refs": [
"<string>"
],
"message": "<string>"
}
],
"current_offer": {
"content_markdown": "<string>",
"display_label": "<string>",
"document_id": "<string>",
"offer_id": "<string>",
"published_url": "<string>",
"source_sha256": "<string>",
"title": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"version_id": "<string>"
},
"current_organization": {
"legal_entity_name": "<string>",
"profile_revision": 2
},
"detail": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
],
"next_actions": [
{
"action": "<string>",
"actor": "<string>"
}
],
"reason": "agreement_terminated",
"reason_code": "access_unverified",
"retry_after_s": 123
}Authorizations
bearerAuthsessionCookie
Organization API key for application requests.
Body
application/json
Required range:
x >= 1Required string length:
1 - 200Show child attributes
Show child attributes
Required array length:
1 - 20 elementsShow child attributes
Show child attributes
Pattern:
^[a-f0-9]{64}$Show child attributes
Show child attributes
Required string length:
1 - 200Required range:
x >= 1Response
Default Response
Show child attributes
Show child attributes
Maximum array length:
20Show child attributes
Show child attributes
Show child attributes
Show child attributes
Required range:
0 <= x <= 9007199254740991Required range:
0 <= x <= 9007199254740991Pattern:
^[a-f0-9]{64}$Maximum string length:
16384Available options:
true Required range:
0 <= x <= 9007199254740991Show child attributes
Show child attributes
Available options:
byok-selected-checks/v1 ⌘I
Review selected model checks
curl --request POST \
--url https://api.getmillwork.dev/v1/model-check-batches/plan \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"binding_revision": 2,
"connection_id": "<string>",
"filter": {
"connection_id": "<string>",
"include_tested": true,
"limit": 100,
"model_group_key": "<string>",
"publisher_id": "<string>",
"q": "<string>",
"source_id": "<string>"
},
"selected": [
{
"arm_id": "<string>",
"authority_id": "<string>",
"item_id": "<string>",
"observation_revision": "<string>",
"route_id": "<string>",
"snapshot_id": "<string>"
}
],
"snapshot_digest": "<string>",
"task": {
"objective": "<string>"
}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
binding_revision: 2,
connection_id: '<string>',
filter: {
connection_id: '<string>',
include_tested: true,
limit: 100,
model_group_key: '<string>',
publisher_id: '<string>',
q: '<string>',
source_id: '<string>'
},
selected: [
{
arm_id: '<string>',
authority_id: '<string>',
item_id: '<string>',
observation_revision: '<string>',
route_id: '<string>',
snapshot_id: '<string>'
}
],
snapshot_digest: '<string>',
task: {objective: '<string>'}
})
};
fetch('https://api.getmillwork.dev/v1/model-check-batches/plan', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"confirmation_expires_at": "<string>",
"counts": {
"approved_real_checks": 4503599627370495,
"blocked": 4503599627370495,
"eligible": 4503599627370495,
"selected": 4503599627370495
},
"expires_at": "<string>",
"items": [
{
"blockers": [
{
"action": "<string>",
"actor": "<string>",
"code": "access_unverified",
"evidence_refs": [
"<string>"
],
"message": "<string>"
}
],
"execution": {
"byok_inventory": {
"authority_id": "<string>",
"original_inputs": {
"item_id": "<string>",
"observation_revision": "<string>",
"purpose": "add",
"route_id": "<string>",
"authority_id": "<string>",
"task": {
"objective": "<string>"
},
"task_envelope": {
"data_classes": [
"public"
],
"max_input_tokens": 2,
"max_output_tokens": 2,
"max_runtime_s": 2,
"max_reasoning_tokens": 2
}
},
"plan_digest": "<string>",
"plan_token": "<string>",
"price_approval_sha256": "<string>",
"provider_usage_budget_usd": 1
},
"mode": "live",
"policy": {
"budget": {
"max_cost_usd": 123,
"max_runtime_s": 2
},
"data_classes": [
"public"
],
"on_eval": [
"gate"
]
},
"routing": {
"required_arm_id": "<string>"
},
"task": {
"objective": "<string>"
}
},
"plan": {
"binding_revision": 1,
"bound": {
"assumptions": [
"<string>"
],
"input_volume_tokens": 1,
"meters": [
{
"maximum_microusd": 1,
"maximum_volume": 1,
"meter": "<string>",
"rate_usd": "<string>"
}
],
"output_volume_tokens": 1,
"provider_maximum_microusd": 1,
"rate_digest": "<string>",
"source_contract_revision": "<string>",
"anthropic_evidence": {
"evidence_refs": [
"<string>"
],
"expires_at": "<string>",
"input_usd_per_token": "<string>",
"output_usd_per_token": "<string>",
"proof_digest": "<string>",
"request_usd": "<string>",
"resolved_model_ids": [
"<string>"
],
"version": "anthropic.messages/v1"
},
"class_evidence": {
"evidence_refs": [
"<string>"
],
"expected_provider": "<string>",
"expires_at": "<string>",
"meter_limits": [
{
"maximum_volume": 1,
"meter": "<string>",
"usage_field": "prompt_tokens"
}
],
"partitions": [
{
"maximum_volume": 1,
"partition": "<string>",
"usage_fields": [
"<string>"
]
}
],
"proof_digest": "<string>",
"reasoning_maximum_tokens": 1,
"reasoning_mode": "disabled",
"resolved_model_ids": [
"<string>"
],
"revision": "<string>",
"version": "openrouter.classes/v1"
}
},
"confirmation_expires_at": "<string>",
"connection_id": "<string>",
"evaluated_at": "<string>",
"invocation_id": "<string>",
"item_id": "<string>",
"observation_revision": "<string>",
"permission_expires_at": "<string>",
"plan_digest": "<string>",
"plan_token": "<string>",
"prepared_request": {
"max_tokens": 1,
"model": "<string>",
"provider": {
"allow_fallbacks": false,
"data_collection": "deny",
"max_price": {},
"only": [
"<string>"
],
"order": [
"<string>"
],
"require_parameters": true
},
"stream": false,
"usage": {
"include": true
},
"reasoning": {
"effort": "none"
}
},
"purpose": "add",
"readiness": {
"blockers": [
{
"action": "<string>",
"actor": "<string>",
"code": "access_unverified",
"evidence_refs": [
"<string>"
],
"message": "<string>"
}
],
"disposition": "ready",
"evaluated_at": "<string>",
"planner_version": "<string>",
"policy_revision": 1
},
"route_id": "<string>",
"source_id": "<string>",
"task_envelope": {
"data_classes": [
"public"
],
"max_input_tokens": 2,
"max_output_tokens": 2,
"max_runtime_s": 2,
"max_reasoning_tokens": 2
},
"testing": {
"evidence_ref": "<string>",
"last_tested_at": "<string>",
"state": "recorded"
}
},
"quote": {
"authority_id": "<string>",
"bound": {
"assumptions": [
"<string>"
],
"input_volume_tokens": 1,
"meters": [
{
"maximum_microusd": 1,
"maximum_volume": 1,
"meter": "<string>",
"rate_usd": "<string>"
}
],
"output_volume_tokens": 1,
"provider_maximum_microusd": 1,
"rate_digest": "<string>",
"source_contract_revision": "<string>",
"anthropic_evidence": {
"evidence_refs": [
"<string>"
],
"expires_at": "<string>",
"input_usd_per_token": "<string>",
"output_usd_per_token": "<string>",
"proof_digest": "<string>",
"request_usd": "<string>",
"resolved_model_ids": [
"<string>"
],
"version": "anthropic.messages/v1"
},
"class_evidence": {
"evidence_refs": [
"<string>"
],
"expected_provider": "<string>",
"expires_at": "<string>",
"meter_limits": [
{
"maximum_volume": 1,
"meter": "<string>",
"usage_field": "prompt_tokens"
}
],
"partitions": [
{
"maximum_volume": 1,
"partition": "<string>",
"usage_fields": [
"<string>"
]
}
],
"proof_digest": "<string>",
"reasoning_maximum_tokens": 1,
"reasoning_mode": "disabled",
"resolved_model_ids": [
"<string>"
],
"revision": "<string>",
"version": "openrouter.classes/v1"
}
},
"expires_at": "<string>",
"maximum_combined_usd": 123,
"millwork_fee_usd": 123,
"model_deployment_id": "<string>",
"plan_digest": "<string>",
"price_approval_sha256": "<string>",
"provider_invoice_authoritative": true,
"provider_maximum_usd": 123,
"provider_usage_budget_usd": 123,
"schema_version": "byok-inventory-quote/v1"
},
"selection": {
"arm_id": "<string>",
"authority_id": "<string>",
"item_id": "<string>",
"observation_revision": "<string>",
"route_id": "<string>",
"snapshot_id": "<string>"
}
}
],
"limits": {
"attempts": 1,
"in_flight": 1,
"items": 20
},
"millwork_maximum_cents": 4503599627370495,
"ordinary_fee_cents": 4503599627370495,
"plan_digest": "<string>",
"plan_token": "<string>",
"provider_invoice_authoritative": true,
"provider_maximum_microusd": 4503599627370495,
"request": {
"binding_revision": 2,
"connection_id": "<string>",
"filter": {
"access_lane": "byok",
"connection_id": "<string>",
"include_tested": true,
"limit": 100,
"model_group_key": "<string>",
"publisher_id": "<string>",
"q": "<string>",
"readiness": "ready",
"source_id": "<string>",
"view": "routes"
},
"selected": [
{
"arm_id": "<string>",
"authority_id": "<string>",
"item_id": "<string>",
"observation_revision": "<string>",
"route_id": "<string>",
"snapshot_id": "<string>"
}
],
"snapshot_digest": "<string>",
"task": {
"objective": "<string>"
},
"batch_id": "<string>",
"expected_revision": 2
},
"version": "byok-selected-checks/v1"
}{
"instance": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": 123,
"title": "<string>",
"type": "<string>",
"blockers": [
{
"action": "<string>",
"actor": "<string>",
"code": "access_unverified",
"evidence_refs": [
"<string>"
],
"message": "<string>"
}
],
"current_offer": {
"content_markdown": "<string>",
"display_label": "<string>",
"document_id": "<string>",
"offer_id": "<string>",
"published_url": "<string>",
"source_sha256": "<string>",
"title": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"version_id": "<string>"
},
"current_organization": {
"legal_entity_name": "<string>",
"profile_revision": 2
},
"detail": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
],
"next_actions": [
{
"action": "<string>",
"actor": "<string>"
}
],
"reason": "agreement_terminated",
"reason_code": "access_unverified",
"retry_after_s": 123
}{
"instance": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": 123,
"title": "<string>",
"type": "<string>",
"blockers": [
{
"action": "<string>",
"actor": "<string>",
"code": "access_unverified",
"evidence_refs": [
"<string>"
],
"message": "<string>"
}
],
"current_offer": {
"content_markdown": "<string>",
"display_label": "<string>",
"document_id": "<string>",
"offer_id": "<string>",
"published_url": "<string>",
"source_sha256": "<string>",
"title": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"version_id": "<string>"
},
"current_organization": {
"legal_entity_name": "<string>",
"profile_revision": 2
},
"detail": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
],
"next_actions": [
{
"action": "<string>",
"actor": "<string>"
}
],
"reason": "agreement_terminated",
"reason_code": "access_unverified",
"retry_after_s": 123
}