Create Task¶
Tasks are created via the Laravel API's NotepadController. A task is a notepad
entry without a repair link (entry_type = task).
Creating via the API¶
| Field | Required | Description |
|---|---|---|
comment |
Yes | Task text (up to 2048 characters) |
date_time |
No | Due date/time (default: now) |
status |
No | Status (status type notepad, default: new) |
assigned_to |
No | Assigned user (user ID) |
assigned_to_group |
No | Assigned group |
additional_recipients |
No | Additional recipients (list of user IDs) |
inventory_id |
No | Linked inventory item |
customer_id |
No | Linked customer |
contact_id |
No | Linked contact |
repair_id |
No | Linked repair — turns the entry into a maintenance reminder |
Priority
The V2 data model has no dedicated priority column. Urgency is expressed
through the due date (date_time) and the status (status).
Creating from the Calendar¶
From the calendar a task can be created for multiple inventory items in one step (one entry per item; the customer is inherited from the item):
| Field | Required | Description |
|---|---|---|
comment |
Yes | Task text |
inventory_ids |
Yes | List of inventory items (one entry per item) |
date_time |
Yes | Due date/time |
assigned_to |
No | Assigned user |
contact_id |
No | Linked contact |
status |
No | Status (default: new) |
Status Workflow¶
The status follows the configured status system (status type notepad). A status
change is performed via:
If the target status is missing mandatory fields, the API responds with 422 and
the list of required fields; these are supplied via
POST /api/v2/notepads/{id}/additional-fields.
Permissions¶
Creating and editing requires the notepad_edit permission.