POST https://api.d-tools.com/SI/Publish/Task
Publish a new task to SI.
Request Information
URI Parameters
None.
Body Parameters
The Task.
NewTask| Name | Description | Type | Additional information |
|---|---|---|---|
| IntegrationId |
Id for the task (Optional). The Id must be a valid Guid and can be used to retrieve task. |
string |
None. |
| ProjectId |
Id of the Project (Required and ProjectId must exist in SI) |
string |
None. |
| Name |
Name (Required) |
string |
None. |
| Start |
Start date required (Required) |
date |
None. |
| End |
End date required (Required) |
date |
None. |
| Description |
Description of the task |
string |
None. |
| Contact |
Contact information |
ContactInfo |
None. |
| SiteAddress |
Site address information |
Address |
None. |
| Resources |
Resources in a task |
Collection of TaskResource |
None. |
Request Formats
application/json, text/json
Sample:
{
"IntegrationId": "sample string 1",
"ProjectId": "sample string 2",
"Name": "sample string 3",
"Start": "2025-12-21T18:01:15.1075315+00:00",
"StartTicks": 5,
"End": "2025-12-21T18:01:15.1085493+00:00",
"EndTicks": 7,
"Description": "sample string 8",
"Contact": {
"Name": "sample string 1",
"Title": "sample string 2",
"Email": "sample string 3",
"Phone": "sample string 4",
"Mobile": "sample string 5"
},
"SiteAddress": {
"Street1": "sample string 1",
"Street2": "sample string 2",
"City": "sample string 3",
"State": "sample string 4",
"PostalCode": "sample string 5",
"Country": "sample string 6",
"Phone": "sample string 7",
"Fax": "sample string 8"
},
"Resources": [
{
"Name": "sample string 1",
"Email": "sample string 2",
"EstimatedHours": 1.0,
"ActualHours": 1.0,
"Cost": 1.0
},
{
"Name": "sample string 1",
"Email": "sample string 2",
"EstimatedHours": 1.0,
"ActualHours": 1.0,
"Cost": 1.0
}
]
}
application/xml, text/xml
Sample:
<NewTask xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DTools.SICloudAPI.DataObjects">
<Contact>
<Email>sample string 3</Email>
<Mobile>sample string 5</Mobile>
<Name>sample string 1</Name>
<Phone>sample string 4</Phone>
<Title>sample string 2</Title>
</Contact>
<Description>sample string 8</Description>
<End>2025-12-21T18:01:15.1085493+00:00</End>
<EndTicks>7</EndTicks>
<IntegrationId>sample string 1</IntegrationId>
<Name>sample string 3</Name>
<ProjectId>sample string 2</ProjectId>
<Resources>
<TaskResource>
<ActualHours>1</ActualHours>
<Cost>1</Cost>
<Email>sample string 2</Email>
<EstimatedHours>1</EstimatedHours>
<Name>sample string 1</Name>
</TaskResource>
<TaskResource>
<ActualHours>1</ActualHours>
<Cost>1</Cost>
<Email>sample string 2</Email>
<EstimatedHours>1</EstimatedHours>
<Name>sample string 1</Name>
</TaskResource>
</Resources>
<SiteAddress>
<City>sample string 3</City>
<Country>sample string 6</Country>
<Fax>sample string 8</Fax>
<Phone>sample string 7</Phone>
<PostalCode>sample string 5</PostalCode>
<State>sample string 4</State>
<Street1>sample string 1</Street1>
<Street2>sample string 2</Street2>
</SiteAddress>
<Start>2025-12-21T18:01:15.1075315+00:00</Start>
<StartTicks>5</StartTicks>
</NewTask>
application/x-www-form-urlencoded
Sample:
Response Information
Resource Description
PublishResponse| Name | Description | Type | Additional information |
|---|---|---|---|
| MessageId |
Check the status of the transaction using this Message Id |
globally unique identifier |
None. |
| Message |
Success Message |
string |
None. |
Response Formats
application/json, text/json
Sample:
{
"MessageId": "2623ccb8-de4e-412c-9eaf-96187ad78e46",
"Message": "sample string 2"
}
application/xml, text/xml
Sample:
<PublishResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DTools.SICloudAPI.DataObjects"> <Message>sample string 2</Message> <MessageId>2623ccb8-de4e-412c-9eaf-96187ad78e46</MessageId> </PublishResponse>