parameter_unknown | The body has a field the route does not take. The body is closed. A field that a block of a document does not have is 422 document_invalid instead, with its path in param. Every route also refuses a query parameter it does not take with this code, and param is its name. The check comes before the key is read, so an unknown query parameter without a key is a 400, not a 401. |
invalid_query | Declared for a query string that cannot be read at all. The server does not produce it today: it reads even a malformed query string, and what is wrong comes back as parameter_unknown for a parameter the route does not take and as parameter_invalid for a value that is not allowed, such as status=queued. Handle it like any other 400. |
already_exists | The object is there already (a concurrent create). The message says “Retry the request”: send the same request again, with the same Idempotency-Key if it had one. See Idempotency. |
parameter_invalid | A field has the wrong type or an invalid value, for example document that is an object and not an array of blocks. The message says where the text of the earlier form goes now. |
insufficient_scope | The key lacks the scope of the call. It is answered before anything is looked up. |
resource_missing | No such object, another organization’s object, a deleted one, an id that does not parse, or a MAC address where a printer id belongs. All look the same. |
customer_suspended, location_suspended | The customer or location is paused, so no job can be queued. See Suspension and pause. |
pending_jobs | You moved a printer that has jobs waiting. Send cancel_pending_jobs: true, or wait. |
job_not_cancellable | The printer has taken the job, or it has ended. |
printer_not_identified | A change to the profile, print_options or allowed_mac of a printer, or welcome_print turned on, before the maker of a printer added by its paper width is known. Send it again after the printer has connected. See Profiles and print options. |
idempotency_key_reused | The Idempotency-Key was used with a different request. See Idempotency. |
document_invalid | A job has both document and receiptline, or neither, or a block cannot be printed as it is said. param is the path of the first problem, such as document[3].rows[1][0].size. See Errors in a document. |
document_empty, document_too_large, rendered_too_large, request_too_large, render_timeout | The document is blank or prints nothing, or it is too large or too slow to render. See Receipt documents. |
document_command_not_allowed | The document uses the command property, or a hexadecimal escape that would put a control character into the text. The message gives the line and the column. |
profile_unknown, profile_not_connectable, profile_vendor_mismatch, print_options_invalid | The profile or print_options of a printer were refused. See Profiles and print options. |
profile_mismatch | The printer reported a model of Star’s Line mode family, and its profile cannot print on it. Star Line printers cannot be used through the API yet. |
queue_full | The printer already has 50 jobs waiting. |
rate_limited | Too many test prints for one printer. |
printer_domain_unavailable | No printer domain is active, so a printer URL cannot be made. Try again later. |
internal_error | Something failed on Tillcast’s side and nothing was queued. Retry with the same Idempotency-Key, and quote the request id if it persists. |