Agentic draft

POST

/shipping/orders/drafts/build/v1

Creates a draft order from an ad-hoc core or saved template. When both a core and template ID are supplied, the core drives the build and the template ID is recorded as provenance. | authz: min_org_role=operator | (OrderBuilderReq) -> (OrderBuilderRes)

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

order_template_coreobjectOptional

Build input. Required if order_template_id is omitted. When both are provided, this edited core is used instead of the saved template.

order_template_idstringOptional

Saved-template provenance. Required if order_template_core is omitted. When provided, it is authorized for the caller and marked used when the draft opens.

stream_order_parsing_progress_updatesbooleanOptionalDefaults to true

Response

Successful Response

summarystring

noteslist of strings

order_idstring

order_short_idstring

validation_issueslist of strings

validation_passedbooleanDefaults to false

Errors

422

Drafts Build V1request Unprocessable Entity Error

1	import { ChrtClient } from "@chrt-inc/typescript-sdk";
2
3	async function main() {
4	const client = new ChrtClient({
5	token: "YOUR_TOKEN_HERE",
6	});
7	await client.shipping.orders.drafts.buildV1({});
8	}
9	main();

1	{
2	"summary": "summary",
3	"notes": [
4	"notes"
5	],
6	"order_id": "order_id",
7	"order_short_id": "order_short_id",
8	"validation_issues": [
9	"validation_issues"
10	],
11	"validation_passed": true
12	}