The job body is an array of blocks
This is a breaking change of the body of a job, made under the same API version, 2026-10-01. There is no alias and no migration period: the earlier body is refused. SDK 0.2.0 follows and sends the new body.
documentis an array of blocks. Each block is one visible unit and says itstype:text,row,table,rule,cut,feed,barcode,qrorimage. Tillcast renders the document for the printer’s profile, as before. The text of a block prints as it is written, so there is nothing to escape. See Receipt documents.receiptlineis the field for ReceiptLine text. It is for documents written for other ReceiptLine tools. The escape rule applies to this text only. To keep a document as it is, send the text that wasdocument.contentasreceiptline.- Exactly one of the two. A job with both
documentandreceiptline, or with neither, is422 document_invalid. A job with no document at all was400 parameter_missingbefore. - The earlier body is gone.
{"document": {"type": "receiptline", "content": "..."}}is400 parameter_invalid, and the message says where the text goes now. Where an error saiddocument.contentinparam, it now saysreceiptline. - A new error for blocks. A block that cannot be printed as it is said is
422 document_invalid, andparamis the path of the first problem, such asdocument[3].rows[1][0].size. - SDKs. Version 0.1.1 of
@tillcast/sdkandtillcastsends the earlier object, and the API refuses it. Version 0.2.0 sends the array. In Python the blocks, and alsoprint_options, are written as plain dicts, and a type checker no longer accepts the model classes of 0.1.1 in a request. See SDKs. - Pages. The examples of the Quickstart, Jobs, Idempotency, Integrate a point of sale and SDKs send blocks, and so does the
AGENTS.mdsnippet of Build with an agent.
One field for your own IDs, and a full test page
client_reference_id. Customers, locations, printers and jobs carry the id they have in your own system in one field with one name. It is not unique, and every list can search by it. It replacesexternal_idon customers and locations andreferenceon jobs, which are now refused with400 parameter_unknown. See Your own IDs.- The
external_id_takenerror is gone. A value is never refused for being used already. - Old request shape removed. A job body with
media_typeandpayload_base64is refused like any unknown field. A job carries adocument. - Full test page. Test print in the dashboard queues a long page, about 80 cm of paper, with every barcode type, QR code and image. With the API, call the test print with
?page=full. See First connection. - New page. Integrate a point of sale says what the code of a till or an order system needs.
- SDKs. The TypeScript package
@tillcast/sdkand the Python packagetillcastare published as pre-1.0 versions (0.1.1). See SDKs. The npm packagetillcastwithout a scope is empty and points to@tillcast/sdk.