Creates a new task

Request Information

URI Parameters :

None.

Body Parameters :

task
NameDescriptionTypeAdditional information
id

Primary Key

globally unique identifier
created_by_user_id

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_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_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

company_id

The company linked to this task

globally unique identifier

Optionally required : company_id, company_code or company must be provided

contact_id

globally unique identifier
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_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
customer_reference

Reference of this task for the customer

string

Max length: 4000

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_update

Updated 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
dateutc_assigned

Date+Time UTC 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

next_task_activity_id

globally unique identifier
next_task_activity_log_id

globally unique identifier
requested_by_company_id

globally unique identifier
requested_by_contact_id

globally unique identifier
bill_to_party

string

Max length: 255

dateutc_create

date
created_by_servicedesk_api

It is set to TRUE when the task has been created via servicedesk.

boolean
modified_dateutc

Readonly system field managed by database, filled with GetUtcDate when adding,updating

date
internal_remark

Internal remark of the Task

string

Max length: 4000

dateutc_max_sla_hands_on_machine

Readonly system field managed by database, filled with GetUtcDate when adding,updating

date
dateutc_max_sla_resolution

Readonly system field managed by database, filled with GetUtcDate when adding,updating

date
dateutc_max_sla_contact

date
dont_apply_sla

boolean
udf1

string

Max length: 4000

udf2

string

Max length: 4000

udf3

string

Max length: 4000

udf4

string

Max length: 4000

udf5

string

Max length: 4000

udf6

string

Max length: 4000

udf7

string

Max length: 4000

udf8

string

Max length: 4000

udf9

string

Max length: 4000

udf10

string

Max length: 4000

udf11

string

Max length: 4000

udf12

string

Max length: 4000

udf13

string

Max length: 4000

udf14

string

Max length: 4000

udf15

string

Max length: 4000

udf16

string

Max length: 4000

udf17

string

Max length: 4000

udf18

string

Max length: 4000

udf19

string

Max length: 4000

udf20

string

Max length: 4000

udf21

string

Max length: 4000

udf22

string

Max length: 4000

udf23

string

Max length: 4000

udf24

string

Max length: 4000

udf25

string

Max length: 4000

udf26

string

Max length: 4000

udf27

string

Max length: 4000

udf28

string

Max length: 4000

udf29

string

Max length: 4000

udf30

string

Max length: 4000

udf31

string

Max length: 4000

udf32

string

Max length: 4000

udf33

string

Max length: 4000

udf34

string

Max length: 4000

udf35

string

Max length: 4000

udf36

string

Max length: 4000

udf37

string

Max length: 4000

udf38

string

Max length: 4000

udf39

string

Max length: 4000

udf40

string

Max length: 4000

udf41

string

Max length: 4000

udf42

string

Max length: 4000

udf43

string

Max length: 4000

udf44

string

Max length: 4000

udf45

string

Max length: 4000

udf46

string

Max length: 4000

udf47

string

Max length: 4000

udf48

string

Max length: 4000

udf49

string

Max length: 4000

udf50

string

Max length: 4000

udf51

string

Max length: 4000

udf52

string

Max length: 4000

udf53

string

Max length: 4000

udf54

string

Max length: 4000

udf55

string

Max length: 4000

udf56

string

Max length: 4000

udf57

string

Max length: 4000

udf58

string

Max length: 4000

udf59

string

Max length: 4000

udf60

string

Max length: 4000

udf61

string

Max length: 4000

udf62

string

Max length: 4000

udf63

string

Max length: 4000

udf64

string

Max length: 4000

udf65

string

Max length: 4000

udf66

string

Max length: 4000

udf67

string

Max length: 4000

udf68

string

Max length: 4000

udf69

string

Max length: 4000

udf70

string

Max length: 4000

udf71

string

Max length: 4000

udf72

string

Max length: 4000

udf73

string

Max length: 4000

udf74

string

Max length: 4000

udf75

string

Max length: 4000

udf76

string

Max length: 4000

udf77

string

Max length: 4000

udf78

string

Max length: 4000

udf79

string

Max length: 4000

udf80

string

Max length: 4000

udf81

string

Max length: 4000

udf82

string

Max length: 4000

udf83

string

Max length: 4000

udf84

string

Max length: 4000

udf85

string

Max length: 4000

udf86

string

Max length: 4000

udf87

string

Max length: 4000

udf88

string

Max length: 4000

udf89

string

Max length: 4000

udf90

string

Max length: 4000

udf91

string

Max length: 4000

udf92

string

Max length: 4000

udf93

string

Max length: 4000

udf94

string

Max length: 4000

udf95

string

Max length: 4000

udf96

string

Max length: 4000

udf97

string

Max length: 4000

udf98

string

Max length: 4000

udf99

string

Max length: 4000

udf100

string

Max length: 4000

Request Formats :

application/json, text/json

Sample:
{
  "id": "dd094795-989b-49e0-975c-21844c0ce0b3",
  "created_by_user_id": "29253970-1c19-4a41-a818-5961059b7809",
  "task_type_id": "55314be2-e2a7-478c-9a13-5b36a0e475cb",
  "task_status_id": "0c642253-46b2-4adb-883a-48e819238c15",
  "task_priority_id": "7b5da86c-875a-42be-9fc7-36af841b82a2",
  "company_id": "98fb460a-c11b-4755-aee3-4e2fbb9b5912",
  "contact_id": "12e32300-9826-4a14-ac51-9630ddd3b09e",
  "to_db_table_id": "8595a9dd-ff57-4450-849e-25e0a766fe63",
  "to_id_in_table": "5bc45a7f-6d57-46e2-a60a-4ac340aa9b4b",
  "subject": "sample string 10",
  "remark": "sample string 11",
  "customer_reference": "sample string 12",
  "assigned_to_user_id": "589ed480-3824-46c5-aa37-eb08edd23720",
  "assigned_to_user_group_id": "49fccb0a-9cdc-41cf-8366-7924330358d6",
  "date_create": "2026-01-11T20:58:47.1670658+00:00",
  "date_update": "2026-01-11T20:58:47.1670658+00:00",
  "date_start": "2026-01-11T20:58:47.1670658+00:00",
  "due_date": "2026-01-11T20:58:47.1670658+00:00",
  "date_closed": "2026-01-11T20:58:47.1670658+00:00",
  "archived": true,
  "date_assigned": "2026-01-11T20:58:47.1670658+00:00",
  "dateutc_assigned": "2026-01-11T20:58:47.1670658+00:00",
  "date_suggested_by_company": "2026-01-11T20:58:47.1670658+00:00",
  "id2": 24,
  "reference_back_office": "sample string 25",
  "next_task_activity_id": "83c0a8d4-8b06-4d5c-bebe-cf261ac8ad4d",
  "next_task_activity_log_id": "1aef3fb6-6c38-4f5c-aac7-cb2bad99da2c",
  "requested_by_company_id": "8eb08701-d6ab-4d38-8307-2bd323c67d90",
  "requested_by_contact_id": "92f20193-82bf-4ec4-8c60-14d88785f5d0",
  "bill_to_party": "sample string 30",
  "dateutc_create": "2026-01-11T20:58:47.1670658+00:00",
  "created_by_servicedesk_api": true,
  "modified_dateutc": "2026-01-11T20:58:47.1670658+00:00",
  "internal_remark": "sample string 34",
  "dateutc_max_sla_hands_on_machine": "2026-01-11T20:58:47.1670658+00:00",
  "dateutc_max_sla_resolution": "2026-01-11T20:58:47.1670658+00:00",
  "dateutc_max_sla_contact": "2026-01-11T20:58:47.1670658+00:00",
  "dont_apply_sla": true,
  "udf1": "sample string 39",
  "udf2": "sample string 40",
  "udf3": "sample string 41",
  "udf4": "sample string 42",
  "udf5": "sample string 43",
  "udf6": "sample string 44",
  "udf7": "sample string 45",
  "udf8": "sample string 46",
  "udf9": "sample string 47",
  "udf10": "sample string 48",
  "udf11": "sample string 49",
  "udf12": "sample string 50",
  "udf13": "sample string 51",
  "udf14": "sample string 52",
  "udf15": "sample string 53",
  "udf16": "sample string 54",
  "udf17": "sample string 55",
  "udf18": "sample string 56",
  "udf19": "sample string 57",
  "udf20": "sample string 58",
  "udf21": "sample string 59",
  "udf22": "sample string 60",
  "udf23": "sample string 61",
  "udf24": "sample string 62",
  "udf25": "sample string 63",
  "udf26": "sample string 64",
  "udf27": "sample string 65",
  "udf28": "sample string 66",
  "udf29": "sample string 67",
  "udf30": "sample string 68",
  "udf31": "sample string 69",
  "udf32": "sample string 70",
  "udf33": "sample string 71",
  "udf34": "sample string 72",
  "udf35": "sample string 73",
  "udf36": "sample string 74",
  "udf37": "sample string 75",
  "udf38": "sample string 76",
  "udf39": "sample string 77",
  "udf40": "sample string 78",
  "udf41": "sample string 79",
  "udf42": "sample string 80",
  "udf43": "sample string 81",
  "udf44": "sample string 82",
  "udf45": "sample string 83",
  "udf46": "sample string 84",
  "udf47": "sample string 85",
  "udf48": "sample string 86",
  "udf49": "sample string 87",
  "udf50": "sample string 88",
  "udf51": "sample string 89",
  "udf52": "sample string 90",
  "udf53": "sample string 91",
  "udf54": "sample string 92",
  "udf55": "sample string 93",
  "udf56": "sample string 94",
  "udf57": "sample string 95",
  "udf58": "sample string 96",
  "udf59": "sample string 97",
  "udf60": "sample string 98",
  "udf61": "sample string 99",
  "udf62": "sample string 100",
  "udf63": "sample string 101",
  "udf64": "sample string 102",
  "udf65": "sample string 103",
  "udf66": "sample string 104",
  "udf67": "sample string 105",
  "udf68": "sample string 106",
  "udf69": "sample string 107",
  "udf70": "sample string 108",
  "udf71": "sample string 109",
  "udf72": "sample string 110",
  "udf73": "sample string 111",
  "udf74": "sample string 112",
  "udf75": "sample string 113",
  "udf76": "sample string 114",
  "udf77": "sample string 115",
  "udf78": "sample string 116",
  "udf79": "sample string 117",
  "udf80": "sample string 118",
  "udf81": "sample string 119",
  "udf82": "sample string 120",
  "udf83": "sample string 121",
  "udf84": "sample string 122",
  "udf85": "sample string 123",
  "udf86": "sample string 124",
  "udf87": "sample string 125",
  "udf88": "sample string 126",
  "udf89": "sample string 127",
  "udf90": "sample string 128",
  "udf91": "sample string 129",
  "udf92": "sample string 130",
  "udf93": "sample string 131",
  "udf94": "sample string 132",
  "udf95": "sample string 133",
  "udf96": "sample string 134",
  "udf97": "sample string 135",
  "udf98": "sample string 136",
  "udf99": "sample string 137",
  "udf100": "sample string 138"
}

application/xml, text/xml

Sample:
<task xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <archived>true</archived>
  <assigned_to_user_group_id>49fccb0a-9cdc-41cf-8366-7924330358d6</assigned_to_user_group_id>
  <assigned_to_user_id>589ed480-3824-46c5-aa37-eb08edd23720</assigned_to_user_id>
  <bill_to_party>sample string 30</bill_to_party>
  <company_id>98fb460a-c11b-4755-aee3-4e2fbb9b5912</company_id>
  <contact_id>12e32300-9826-4a14-ac51-9630ddd3b09e</contact_id>
  <created_by_servicedesk_api>true</created_by_servicedesk_api>
  <created_by_user_id>29253970-1c19-4a41-a818-5961059b7809</created_by_user_id>
  <customer_reference>sample string 12</customer_reference>
  <date_assigned>2026-01-11T20:58:47.167Z</date_assigned>
  <date_closed>2026-01-11T20:58:47.167Z</date_closed>
  <date_create>2026-01-11T20:58:47.167Z</date_create>
  <date_start>2026-01-11T20:58:47.167Z</date_start>
  <date_suggested_by_company>2026-01-11T20:58:47.167Z</date_suggested_by_company>
  <date_update>2026-01-11T20:58:47.167Z</date_update>
  <dateutc_assigned>2026-01-11T20:58:47.167Z</dateutc_assigned>
  <dateutc_create>2026-01-11T20:58:47.167Z</dateutc_create>
  <dateutc_max_sla_contact>2026-01-11T20:58:47.167Z</dateutc_max_sla_contact>
  <dateutc_max_sla_hands_on_machine>2026-01-11T20:58:47.167Z</dateutc_max_sla_hands_on_machine>
  <dateutc_max_sla_resolution>2026-01-11T20:58:47.167Z</dateutc_max_sla_resolution>
  <dont_apply_sla>true</dont_apply_sla>
  <due_date>2026-01-11T20:58:47.167Z</due_date>
  <id>dd094795-989b-49e0-975c-21844c0ce0b3</id>
  <id2>24</id2>
  <internal_remark>sample string 34</internal_remark>
  <modified_dateutc>2026-01-11T20:58:47.167Z</modified_dateutc>
  <next_task_activity_id>83c0a8d4-8b06-4d5c-bebe-cf261ac8ad4d</next_task_activity_id>
  <next_task_activity_log_id>1aef3fb6-6c38-4f5c-aac7-cb2bad99da2c</next_task_activity_log_id>
  <reference_back_office>sample string 25</reference_back_office>
  <remark>sample string 11</remark>
  <requested_by_company_id>8eb08701-d6ab-4d38-8307-2bd323c67d90</requested_by_company_id>
  <requested_by_contact_id>92f20193-82bf-4ec4-8c60-14d88785f5d0</requested_by_contact_id>
  <subject>sample string 10</subject>
  <task_priority_id>7b5da86c-875a-42be-9fc7-36af841b82a2</task_priority_id>
  <task_status_id>0c642253-46b2-4adb-883a-48e819238c15</task_status_id>
  <task_type_id>55314be2-e2a7-478c-9a13-5b36a0e475cb</task_type_id>
  <to_db_table_id>8595a9dd-ff57-4450-849e-25e0a766fe63</to_db_table_id>
  <to_id_in_table>5bc45a7f-6d57-46e2-a60a-4ac340aa9b4b</to_id_in_table>
  <udf1>sample string 39</udf1>
  <udf10>sample string 48</udf10>
  <udf100>sample string 138</udf100>
  <udf11>sample string 49</udf11>
  <udf12>sample string 50</udf12>
  <udf13>sample string 51</udf13>
  <udf14>sample string 52</udf14>
  <udf15>sample string 53</udf15>
  <udf16>sample string 54</udf16>
  <udf17>sample string 55</udf17>
  <udf18>sample string 56</udf18>
  <udf19>sample string 57</udf19>
  <udf2>sample string 40</udf2>
  <udf20>sample string 58</udf20>
  <udf21>sample string 59</udf21>
  <udf22>sample string 60</udf22>
  <udf23>sample string 61</udf23>
  <udf24>sample string 62</udf24>
  <udf25>sample string 63</udf25>
  <udf26>sample string 64</udf26>
  <udf27>sample string 65</udf27>
  <udf28>sample string 66</udf28>
  <udf29>sample string 67</udf29>
  <udf3>sample string 41</udf3>
  <udf30>sample string 68</udf30>
  <udf31>sample string 69</udf31>
  <udf32>sample string 70</udf32>
  <udf33>sample string 71</udf33>
  <udf34>sample string 72</udf34>
  <udf35>sample string 73</udf35>
  <udf36>sample string 74</udf36>
  <udf37>sample string 75</udf37>
  <udf38>sample string 76</udf38>
  <udf39>sample string 77</udf39>
  <udf4>sample string 42</udf4>
  <udf40>sample string 78</udf40>
  <udf41>sample string 79</udf41>
  <udf42>sample string 80</udf42>
  <udf43>sample string 81</udf43>
  <udf44>sample string 82</udf44>
  <udf45>sample string 83</udf45>
  <udf46>sample string 84</udf46>
  <udf47>sample string 85</udf47>
  <udf48>sample string 86</udf48>
  <udf49>sample string 87</udf49>
  <udf5>sample string 43</udf5>
  <udf50>sample string 88</udf50>
  <udf51>sample string 89</udf51>
  <udf52>sample string 90</udf52>
  <udf53>sample string 91</udf53>
  <udf54>sample string 92</udf54>
  <udf55>sample string 93</udf55>
  <udf56>sample string 94</udf56>
  <udf57>sample string 95</udf57>
  <udf58>sample string 96</udf58>
  <udf59>sample string 97</udf59>
  <udf6>sample string 44</udf6>
  <udf60>sample string 98</udf60>
  <udf61>sample string 99</udf61>
  <udf62>sample string 100</udf62>
  <udf63>sample string 101</udf63>
  <udf64>sample string 102</udf64>
  <udf65>sample string 103</udf65>
  <udf66>sample string 104</udf66>
  <udf67>sample string 105</udf67>
  <udf68>sample string 106</udf68>
  <udf69>sample string 107</udf69>
  <udf7>sample string 45</udf7>
  <udf70>sample string 108</udf70>
  <udf71>sample string 109</udf71>
  <udf72>sample string 110</udf72>
  <udf73>sample string 111</udf73>
  <udf74>sample string 112</udf74>
  <udf75>sample string 113</udf75>
  <udf76>sample string 114</udf76>
  <udf77>sample string 115</udf77>
  <udf78>sample string 116</udf78>
  <udf79>sample string 117</udf79>
  <udf8>sample string 46</udf8>
  <udf80>sample string 118</udf80>
  <udf81>sample string 119</udf81>
  <udf82>sample string 120</udf82>
  <udf83>sample string 121</udf83>
  <udf84>sample string 122</udf84>
  <udf85>sample string 123</udf85>
  <udf86>sample string 124</udf86>
  <udf87>sample string 125</udf87>
  <udf88>sample string 126</udf88>
  <udf89>sample string 127</udf89>
  <udf9>sample string 47</udf9>
  <udf90>sample string 128</udf90>
  <udf91>sample string 129</udf91>
  <udf92>sample string 130</udf92>
  <udf93>sample string 131</udf93>
  <udf94>sample string 132</udf94>
  <udf95>sample string 133</udf95>
  <udf96>sample string 134</udf96>
  <udf97>sample string 135</udf97>
  <udf98>sample string 136</udf98>
  <udf99>sample string 137</udf99>
</task>

Response Information

Resource Description :

IHttpActionResult

None.

Response Formats

application/json, text/json, application/xml, text/xml

Sample:

Sample not available.