Returns dialogs associated with the given individual, this includes dialogs for that individual as well any dialog where there is a task that has been assigned to the given individual.
startDate
date
Returns dialogs from this date forward. |
endDate
date
If set with StartDate returns up to this date, otherwise only returns this date. |
None.
MyOpenTasks
integer
ReadOnly
Number of open tasks on the dialog that are assigned to the given individual. |
OpenTasks
integer
ReadOnly
Number of open tasks on the dialog. |
AncestorName
string
ReadOnly
Name of the ancestor for the dialog. |
Relation
string
ReadOnly
Displays the type of dialog; Org, Ind, dept, ReportsTo. |
ID
globally unique identifier
Required on Update
ID of the given Dialog. |
AncestorID
globally unique identifier
Required on Create
ID of the ancestor of the given dialog. |
DialogDate
date
Required
Date the given dialog was created. |
Name
string
Name of the given dialog. (Max length 255 characters) |
Location
string
Location of the given dialog. (Max length 50 characters) |
Agenda
string
Agenda of the given dialog. |
SiteID
globally unique identifier
ReadOnly
ID of the site for the given dialog. |
AncestorType
byte
ReadOnly
Ancestor type (organization, individual, project, or task) of the given dialog. |
Deleted
boolean
ReadOnly
Deleted status of the given dialog. |
DeletedByRef
boolean
ReadOnly
Deleted by reference status of the given dialog. |
Created
date
ReadOnly
Date that the given dialog was created. |
CreatedBy
globally unique identifier
ReadOnly
ID of the individual that created the given dialog. |
Updated
date
ReadOnly
Date the given dialog was last updated. |
UpdatedBy
globally unique identifier
ReadOnly
ID of the individual that last updated the given dialog. |
Template
boolean
ReadOnly
Indicates the given dialog is a template. |
Draft
boolean
ReadOnly
Indicates the given dialog is a Draft. |
LastCommentDate
date
ReadOnly
Date of the most recent comment for the given dialog. |
LastCommentByID
globally unique identifier
ReadOnly
ID of the individual who posted the most recent comment for the given dialog. |
LastCommentBy
string
ReadOnly
Name of the individual who posted the most recent comment for the given dialog. |
LastComment
string
ReadOnly
Body of the most recent comment for the given dialog. |
CanRead
boolean
ReadOnly
Read security setting for the object based on the current logged in user. |
CanUpdate
boolean
ReadOnly
Update security setting for the object based on the current logged in user. |
CanDelete
boolean
ReadOnly
Delete security setting for the object based on the current logged in user. |
CanDelegate
boolean
ReadOnly
Delegate security setting for the object based on the current logged in user. |
RowType
integer
ReadOnly
Row Type of the dialog (9 = Org Dialog, 25 = Project Dialog, 38 Individual Dialog, |
DialogOccurred
boolean
ReadOnly
This denotes if the system considers the dialog completed or not. For the system to consider it completed a dialog must have either a comment or a follow up task. |
<MyDialog xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4"> <ID>64ad86ca-121f-407e-b8bf-08106fc0527c</ID> <AncestorID>7ea3dd9f-a9c1-4905-b08e-cb0a3caff6e9</AncestorID> <DialogDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System"> <d2p1:DateTime>2025-08-26T17:04:46.1119895Z</d2p1:DateTime> <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes> </DialogDate> <Name>sample string 4</Name> <Location>sample string 5</Location> <Agenda>sample string 6</Agenda> <SiteID>e8513a35-e665-4868-bb3f-499508df071a</SiteID> <AncestorType>64</AncestorType> <Deleted>true</Deleted> <DeletedByRef>true</DeletedByRef> <Created>2025-08-26T17:04:46.1289964+00:00</Created> <CreatedBy>99d51129-8cfc-4f81-a8b1-bfb9d56ae970</CreatedBy> <Updated>2025-08-26T17:04:46.1289964+00:00</Updated> <UpdatedBy>af291e87-8182-4322-af50-0f642080c585</UpdatedBy> <Template>true</Template> <Draft>true</Draft> <LastCommentDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System"> <d2p1:DateTime>2025-08-26T17:04:46.1289964Z</d2p1:DateTime> <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes> </LastCommentDate> <LastCommentByID>8cee3fc9-6f5f-4c31-a320-9ae6a3cdbaf8</LastCommentByID> <LastCommentBy>sample string 7</LastCommentBy> <LastComment>sample string 8</LastComment> <CanRead>true</CanRead> <CanUpdate>true</CanUpdate> <CanDelete>true</CanDelete> <CanDelegate>true</CanDelegate> <RowType>1</RowType> <DialogOccurred>true</DialogOccurred> <MyOpenTasks>1</MyOpenTasks> <OpenTasks>1</OpenTasks> <AncestorName>sample string 1</AncestorName> <Relation>sample string 2</Relation> </MyDialog>
{ "ID": "64ad86ca-121f-407e-b8bf-08106fc0527c", "AncestorID": "7ea3dd9f-a9c1-4905-b08e-cb0a3caff6e9", "DialogDate": "2025-08-26T17:04:46.1119895+00:00", "Name": "sample string 4", "Location": "sample string 5", "Agenda": "sample string 6", "SiteID": "e8513a35-e665-4868-bb3f-499508df071a", "AncestorType": 64, "Deleted": true, "DeletedByRef": true, "Created": "2025-08-26T17:04:46.1289964+00:00", "CreatedBy": "99d51129-8cfc-4f81-a8b1-bfb9d56ae970", "Updated": "2025-08-26T17:04:46.1289964+00:00", "UpdatedBy": "af291e87-8182-4322-af50-0f642080c585", "Template": true, "Draft": true, "LastCommentDate": "2025-08-26T17:04:46.1289964+00:00", "LastCommentByID": "8cee3fc9-6f5f-4c31-a320-9ae6a3cdbaf8", "LastCommentBy": "sample string 7", "LastComment": "sample string 8", "CanRead": true, "CanUpdate": true, "CanDelete": true, "CanDelegate": true, "MyOpenTasks": 1, "RowType": 1, "OpenTasks": 1, "DialogOccurred": true, "AncestorName": "sample string 1", "Relation": "sample string 2" }