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.
|
id
globally unique identifier
Guid ID of the individual for which to return dialogs. |
|
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>c5255162-a9b8-4959-9784-921cdcb43042</ID>
<AncestorID>52c6bde9-6472-482a-a107-dbb3d929d74a</AncestorID>
<DialogDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2025-10-31T15:46:23.5817949Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</DialogDate>
<Name>sample string 4</Name>
<Location>sample string 5</Location>
<Agenda>sample string 6</Agenda>
<SiteID>2c90d4c7-7952-47c1-a7f7-1d2ee5d1b3fc</SiteID>
<AncestorType>64</AncestorType>
<Deleted>true</Deleted>
<DeletedByRef>true</DeletedByRef>
<Created>2025-10-31T15:46:23.5817949+00:00</Created>
<CreatedBy>6302b23c-529e-4c10-8b86-6576094fd362</CreatedBy>
<Updated>2025-10-31T15:46:23.5817949+00:00</Updated>
<UpdatedBy>96040852-b144-4f8c-9ba2-dd1d43160ec0</UpdatedBy>
<Template>true</Template>
<Draft>true</Draft>
<LastCommentDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>2025-10-31T15:46:23.5817949Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</LastCommentDate>
<LastCommentByID>b860f89e-59e9-47e1-a2bb-85efe8f1f8a3</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": "c5255162-a9b8-4959-9784-921cdcb43042",
"AncestorID": "52c6bde9-6472-482a-a107-dbb3d929d74a",
"DialogDate": "2025-10-31T15:46:23.5817949+00:00",
"Name": "sample string 4",
"Location": "sample string 5",
"Agenda": "sample string 6",
"SiteID": "2c90d4c7-7952-47c1-a7f7-1d2ee5d1b3fc",
"AncestorType": 64,
"Deleted": true,
"DeletedByRef": true,
"Created": "2025-10-31T15:46:23.5817949+00:00",
"CreatedBy": "6302b23c-529e-4c10-8b86-6576094fd362",
"Updated": "2025-10-31T15:46:23.5817949+00:00",
"UpdatedBy": "96040852-b144-4f8c-9ba2-dd1d43160ec0",
"Template": true,
"Draft": true,
"LastCommentDate": "2025-10-31T15:46:23.5817949+00:00",
"LastCommentByID": "b860f89e-59e9-47e1-a2bb-85efe8f1f8a3",
"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"
}