Create a task
Create a manual task on an existing ticket. Tasks cannot be added to onboarding tickets (whose tasks are managed automatically).
Authorizations
Use your Primo API key in the Authorization header as Bearer <API_KEY>.
Body
Id of the parent ticket: the 24-character id returned by getTickets or getTicket, not the reference displayed in the product (e.g. IT-1741).
^[a-f\d]{24}$1What the task expects: when it is done and what to do when it is blocked. Shown to whoever opens it.
1LOW, MEDIUM, HIGH ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$Ids of the tags to attach to the task
Open the task on behalf of an employee or email. Defaults to the API key / connected user.
- Option 1
- Option 2
Response
PENDING, IN_PROGRESS, COMPLETED, CANCELLED, SCHEDULED, LOADING, SLEEPING LOW, MEDIUM, HIGH ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$Wake-up date of a SCHEDULED (dormant) task; null on any other status
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$Pick-up date of a SLEEPING task, which nobody sees until then; null on any other status
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$Whether a human (not only the system) may complete this task
Whether only an admin may assign this task or change its status
- Option 1
- Option 2
- Option 3
Ids of the tags attached to this task
Id of the AI agent handling it; null when no agent is on it
Type of a typed task, which Primo runs through its intent (EMPLOYEE_CREATION, EMAIL_ACCOUNT, EMAIL_ACCOUNT_SELECTION, SAAS_SELECTION, SAAS_PROVISIONING, EQUIPMENT_ORDER, OFFBOARDING_CONFIRMATION, DEVICE_HANDLING); null for a plain task
Id of a typed task's intent, to pass to its update and execute tools; null for a plain task