Precheck

POST

/shipping/order_drafts/agentic/precheck/v1

Reports whether an order builder request’s references resolve. | authz: min_org_role=operator | (OrderBuilderReq) -> (OrderTemplateResolvabilityRes)

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

initial_deadline_timestampdatetimeOptional

Per-build pin for the first applied OperationsTask’s deadline (later from_previous_task entries cascade from it). Kept off the template so saved templates don’t carry a stale absolute time; None anchors the chain to the build time.

order_template_coreobjectOptional

Shared seed of an order build: the order text + long-lived references. Reused by the library template (OrderTemplateBase1) and the ad-hoc kickoff payload so the fields the builder seeds from can’t drift. (Mirrors TaskCore1.)

NOTE - some fields have multiple values and must be properly mapped to an entity by the order builder, e.g. for driver_ids each resolves to a single task group

order_template_idstringOptional

Response

Successful Response

validboolean

unresolvable_coordinatorbooleanDefaults to false

unresolvable_directory_entry_idslist of strings

unresolvable_driver_idslist of strings

unresolvable_off_chrt_shipperbooleanDefaults to false

Errors

422

Agentic Precheck V1request Unprocessable Entity Error

1	const url = 'https://localhost:8000/shipping/order_drafts/agentic/precheck/v1';
2	const options = {
3	method: 'POST',
4	headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5	body: '{}'
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}

1	{
2	"valid": true,
3	"unresolvable_coordinator": true,
4	"unresolvable_directory_entry_ids": [
5	"dir_987654321"
6	],
7	"unresolvable_driver_ids": [
8	"drv_123456789"
9	],
10	"unresolvable_off_chrt_shipper": true
11	}