Create draft

POST

/shipping/order_drafts/new/v1

Creates a new draft order with org assignments based on caller’s organization type. | (OrdersNewDraftReq) -> (OrdersNewDraftRes)

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

coordinator_org_idstringOptional

Must be a string starting with org_

creation_idempotency_keystringOptional

Optional key, unique per caller org, that makes draft creation idempotent: re-sending the same key returns the already-created draft instead of creating a duplicate.

department_idstringOptional

initial_deadline_timestampdatetimeOptional

If set, pins the first applied OperationsTask’s deadline; later from_previous_task entries cascade from it. None anchors the chain to the apply time (now).

off_chrt_reference_idstringOptionalformat: "^[A-Za-z0-9._~\-]{1,64}$"1-64 characters

Must be a URL-safe string of 1-64 characters. Allowed characters: A-Z, a-z, 0-9, ’.’, ’_’, ’~’, ’-’ (RFC 3986 unreserved).

off_chrt_shipper_org_idstringOptional

order_thread_shipping_turnobjectOptional

Seed content for the OrderThread’s first user turn (text + long-lived references). Agentic builds supply it; click-ops leaves it None for a blank seed turn.

shipper_org_idstringOptional

Must be a string starting with org_

task_list_idslist of stringsOptional

OperationsTaskList ids to apply to the coordinator’s Case at draft creation; foreign/stale ids are skipped without failing the draft.

Response

Successful Response

order_idstring

order_short_idstring

Errors

422

Order Drafts New V1request Unprocessable Entity Error

1	const url = 'https://localhost:8000/shipping/order_drafts/new/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	}