Creates a new task
Request Information
URI Parameters :
None.
Body Parameters :
task| Name | Description | Type | Additional information |
|---|---|---|---|
| id |
Primary Key |
globally unique identifier | |
| task_type_id |
Foreign key of task type for this task |
globally unique identifier |
Optionally required : task_type_id, task_type_code or task_type must be provided |
| task_type_code |
Embedded entity "task_type" using ERP PK when adding/updating task |
string |
Optionally required : task_type_id, task_type_code or task_type must be provided |
| task_type |
Embedded entity "task_type" when adding/updating task |
task_type |
Optionally required : task_type_id, task_type_code or task_type must be provided |
| task_status_id |
Foreign key of task status for this task.If nothing specified, the system will uses the default task_status available |
globally unique identifier | |
| task_status_reference_back_office |
Embedded entity "task_status" using ERP PK when adding/updating task |
string | |
| task_status |
Embedded entity "task_status" when adding/updating task |
task_status | |
| task_priority_id |
Foreign key of task priority for this task |
globally unique identifier |
Optionally required : task_priority_id, task_priority_code or task_priority must be provided |
| task_priority_code |
Embedded entity "task_priority" using ERP PK when adding/updating task |
string |
Optionally required : task_priority_id, task_priority_code or task_priority must be provided |
| task_priority |
Embedded entity "task_priority" when adding/updating task |
task_priority |
Optionally required : task_priority_id, task_priority_code or task_priority must be provided |
| company_id |
The company linked to this task |
globally unique identifier |
Optionally required : company_id, company_code or company must be provided |
| company_code |
Embedded entity "company" using ERP PK when adding/updating task |
string |
Optionally required : company_id, company_code or company must be provided |
| company |
Embedded entity "company" when adding/updating task |
company |
Optionally required : company_id, company_code or company must be provided |
| to_db_table_id |
Foreign key to the table that is linked to this task (Example:project or jobs) using Guid |
globally unique identifier | |
| to_db_table_name |
Foreign key to the table that is linked to this task (Example:project or jobs) using table name |
string | |
| to_id_in_table |
Foreign key of the object that is linked to this task using Odyssee Guid Primary Key (Exemple:project.id or jobs.id) |
globally unique identifier | |
| subject |
Subject of the Task |
string |
Required Max length: 150 |
| remark |
Remark of the Task (long text area field) |
string | |
| internal_remark | string |
Max length: 4000 |
|
| customer_reference |
Reference of this task for the customer |
string |
Max length: 50 |
| assigned_to_user_id |
Foreign key of the user on which the task has been assigned. If not filled, the system can fill it automatically based on the task_type. When a task is assigned to somebody, the field date_assigned will be filled |
globally unique identifier | |
| assigned_to_user_group_id |
Foreign key of the user_group on which the task will be assigned. If not filled, the system can fill it automatically based on the task_type |
globally unique identifier | |
| date_create |
Creation date+time. Automaticaly filled when adding if no value specified |
date | |
| date_start |
Starting date of the task (date_start in the future are not shown on the UI) |
date | |
| due_date |
Deadline to close the task |
date | |
| date_closed |
Date+Time when the task goes into archive (=completed) |
date | |
| archived |
Indicate that the task is now closed (has been updated to a task status 'Completed').Automatically filled when adding/updating a task based on the task_type |
boolean | |
| date_assigned |
Date+Time when the task has been assigned to a specific user |
date | |
| date_suggested_by_company |
Date+Time suggested by the company to start working on this task |
date | |
| id2 |
Internal ID (numeric). Will be used on the UI to identify easily the task |
integer | |
| reference_back_office |
The Id/Ref of the back office for this task. Used by Embedded entity |
string |
Max length: 50 |
| modified_dateutc |
Readonly system field managed by database, filled with GetUtcDate when adding,updating |
date | |
| contact_id |
Foreign key of contact for this task. |
globally unique identifier | |
| contact_code |
Embedded entity "contact_code" using ERP PK when adding/updating task |
string | |
| contact |
Embedded entity "contact" when adding/updating task |
contact | |
| requested_by_company_id |
Foreign key of company that requested this task. |
globally unique identifier | |
| requested_by_company_code |
Embedded entity "company_code" using ERP PK when adding/updating task |
string | |
| requested_by_company |
Embedded entity "compay" when adding/updating task |
company | |
| bill_to_party |
Bill to party of the Task. |
string |
Request Formats :
application/json, text/json
{
"id": "2619bdfb-dfc9-4eab-93a2-7b4493ac1b94",
"task_type_id": "db16f5e0-9fca-4504-b31f-ce230eecd597",
"task_type_code": "sample string 3",
"task_status_id": "ba6f10f6-3f3a-4df3-b339-3c761a37c8c4",
"task_status_reference_back_office": "sample string 5",
"task_priority_id": "97e7ec5a-a2dc-4c0b-b1de-c5f600e78645",
"task_priority_code": "sample string 7",
"company_id": "a5976655-0324-4b01-9e29-4860ef8ccdcf",
"company_code": "sample string 9",
"to_db_table_id": "910fe14d-cda3-4658-809a-7296b000aa9f",
"to_db_table_name": "sample string 11",
"to_id_in_table": "ddcb4310-5dae-4868-9770-efd2ec33365e",
"subject": "sample string 13",
"remark": "sample string 14",
"internal_remark": "sample string 15",
"customer_reference": "sample string 16",
"assigned_to_user_id": "e8c85a6f-f161-4c79-9f84-767aac261ae8",
"assigned_to_user_group_id": "f0c09b7b-2f25-40ab-a2b8-e72a7205bc23",
"date_create": "2026-11-12T16:08:04.8610332+00:00",
"date_start": "2026-11-12T16:08:04.8610332+00:00",
"due_date": "2026-11-12T16:08:04.8610332+00:00",
"date_closed": "2026-11-12T16:08:04.8610332+00:00",
"archived": true,
"date_assigned": "2026-11-12T16:08:04.8610332+00:00",
"date_suggested_by_company": "2026-11-12T16:08:04.8610332+00:00",
"id2": 26,
"reference_back_office": "sample string 27",
"modified_dateutc": "2026-11-12T16:08:04.8610332+00:00",
"contact_id": "08e37a9d-0ec2-42b7-a93d-dc2dd8c89258",
"contact_code": "sample string 30",
"requested_by_company_id": "b7d66fb9-337d-4c7f-a07d-955459930f7d",
"requested_by_company_code": "sample string 32",
"bill_to_party": "sample string 33"
}
Response Information
Resource Description :
IHttpActionResultNone.
Response Formats
application/json, text/json
Sample not available.