Command: Upsert prepress task - LabelHub/labelhub.integration.documentation GitHub Wiki

UpsertPrepressTaskCommand v2

Properties

UpsertPrepressTaskCommand

Name Type Required Default Notes
identifier string (empty) If none is specified, the command will work just like the CreatePrepressTaskCommand. Otherwise this will be used as lookup key. If multiple matches are found, the latest will be updated.
description string (empty)
dueDate date? (none/null) Format: ISO_8601(e.g YYYY-MM-DD). UTC assumed if not specified!
referenceEmail string? (current user) Defaults to the user creating the prepress task. The email must exist as user in LabelHub! Otherwise it will automatic fallback to the creator user which usually will be a custom integration user.
assigneeEmail string? (none/null) The email must exist as user in LabelHub
brandOwnerNo string? (none/null) The brandowner number, which must exist in LabelHub and must match ALL links!
status string? The desired status of the task. Must be PREPRESSTASK_OPEN, PREPRESSTASK_ONHOLD or PREPRESSTASK_CLOSED. If this field is omitted the status will not be changed.
links array (none) List of links to associate with the task. See Links section for details
metadata array (none) List of metadata to add to the task. See Metadata page for details

Links

Name Type Required Default Notes
linkType string Yes Possible types: labelno
identifier string Yes The identifier key for the given type, e.g. "MLN" for linktype "labelno"

Note that the brandowner must match between the task and ALL links.

Full sample

<?xml version="1.0" encoding="UTF-8"?>
<upsertprepresstaskcommand version="2">
  <identifier>PPT-1234</identifier>
  <description>stuff</description>
  <dueDate>2025-08-21</dueDate>
  <referenceEmail>[email protected]</referenceEmail>
  <assigneeEmail>[email protected]</assigneeEmail>
  <brandOwnerNo>cust1234</brandOwnerNo>
  <status>PREPRESSTASK_OPEN</status>
  <links>
    <link>
      <linkType>labelno</linkType>
      <identifier>101010</identifier>
    </link>
  </links> 
  <metadata>
    <metadata>
      <key>InternalIDs</key>
      <values>
        <value>1234</value>
        <value>PPT-1234</value>
      </values>
    </metadata>
    <metadata>
      <key>CustReference</key>
      <values>
        <value>PO8474</value>
      </values>
    </metadata>
  </metadata> 
</upsertprepresstaskcommand>
⚠️ **GitHub.com Fallback** ⚠️