Task
An object that represents a task, call, message, or todo.
Supported API Calls: Get | Add | Update | Delete
Object Properties
Property |
Type |
Description |
ID |
integer |
Unique identity of a Task object. When adding a new Task object the value must be 0. |
DurationInSeconds |
double |
An optional value. If this task is defined in a project template (a task's Time To Complete Task field), this value sets duration in seconds. This value is optional. |
Subject |
string (100) |
The task's subject. |
DependTask |
string (100) |
If this is a project task, the task this task is dependent on. |
Description |
string (100) |
The task's description field. |
IsReminderSet |
boolean |
Flag to indicate this task should generate a reminder. |
OwnerId |
integer |
The ID of the user who owns this task object. |
Owner |
string (100) |
Name of the task owner. |
ReminderDate |
DateTime |
Optional value. The date the reminder should be sent. |
Priority |
string (100) |
Sets the task dialog box's Priority field. Values are Low, Normal, High. |
Status |
string (100) |
Sets the task dialog box's Status field. Values are: Not Started, In Progress, Completed. |
ParentId |
integer |
If this task is the child of an object (a task under a lead, a task under a project, etc.), enter the ID of the parent object. This value is optional. |
ParentObject |
string (100) |
ParentObject identifies what kind of object the task object is a child of. Values are lead, account (if it's an organization), contact, opportunity, project, case |
StartDate |
DateTime |
Optional. The date the task should start. |
DueDate |
DateTime |
Optional. The date the task is due. |
TaskType |
string (100) |
Determines what kind of task this is. Values are task, call, message, todo |
IsClosed |
boolean |
Flag indicates the task is closed. |
IsLocked |
boolean |
Flag indicates the task is locked and can't be edited. This property is read only |
CreationDate |
DateTime |
Indicates when this object was created. |
LastModifiedBy |
integer |
ID of the user who last modified the object. |
LastModifiedDate |
DateTime |
Date the last time the object was modified. |
IsRecurrence |
boolean |
Flag that indicates the event is repeating. |
RecurrenceType |
string (100) |
Type of repeating event. Possible values are: daily, weekly, monthly, yearly. |
RecurrenceInterval |
integer |
The number of repeats. |
RecurrenceEndDate |
DateTime |
Date the recurrence should end. |
AssigneeName |
string(100) |
Name of the user assigned the task. |
Response |
string(100) |
Values are accepted or rejected. |
Response |
string(100) |
Values are accepted or rejected. |
ReminderTime |
integer |
Time in minutes until a reminder will be sent out. |
OverDue |
string (100) |
Number of days the task is overdue. Example value "overdue|xDayLate|8". The task is 8 days overdue. |
DependencyList |
List<TaskDependency> |
A list of dependencies for this task, if the task is part of a project. |
CallContact |
TaskCallContact |
An object representing a called contact. |
AttachmentList |
List<AttachmentAssociate> |
A list of any attachment objects. |
TaskUser |
TaskUser |
An object representing the user assigned the task. |
Notify |
boolean |
Flag to indicate assigned users should be notified the task has been assigned. |
RelatedParentId |
integer |
ID of the object it is related to. |
RelatedParentObject |
string(100) |
Related object type (project, person, organization, etc.) |
Get
Description
Returns the task specified by the passed id.
URL
https://{company}.bluecamroo.com/api/task/get/{id}
HTTP Method
GET
Parameters
None
Data Return
Returns the task object in the requested format (e.g., JSON or XML)
HTTP Return Status Code
200: Ok
400: Bad Request (One or more input data items is not valid, for example a mandatory field is blank)
401: Not authorized (you need to log in)
403: Forbidden (you don't have permission to this resource)
Add
Description
Adds the task to the list of tasks.
URL
https://{company}.bluecamroo.com/api/task/add
HTTP Method
POST
Parameters
A task object
Data Return
Returns the task object in the requested format (e.g., JSON or XML)
HTTP Return Status Code
201: Created
401: Not authorized (you need to log in)
403: Forbidden (you don't have permission to this resource)
Update
Description
Updates a specified task.
URL
https://{company}.bluecamroo.com/api/task/update
HTTP Method
PUT
Parameters
A task object
Data Return
Returns the task object in the requested format (e.g., JSON or XML)
HTTP Return Status Code
200: Ok
400: Bad Request (One or more input data items is not valid, for example a mandatory field is blank)
401: Not authorized (you need to log in)
403: Forbidden (you don't have permission to this resource)
Delete
Description
Deletes the specified task.
URL
https://{company}.bluecamroo.com/api/task/delete/{id}
HTTP Method
DELETE
Parameters
None
Data Return
None
HTTP Return Status Code
200: Ok
400: Bad Request (One or more input data items is not valid, for example a mandatory field is blank)
401: Not authorized (you need to log in)
403: Forbidden (you don't have permission to this resource)