Read a single dialog.
id
globally unique identifier
Required
Guid ID of the dialog to be read. |
tz
string
Optional parameter to set timezone information. |
None.
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. |
<Dialog xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4"> <ID>90e7ebf4-397d-47ee-aaaf-b33b5717ec1c</ID> <AncestorID>0cb9c05e-e833-4364-8a20-4f4c9601febf</AncestorID> <DialogDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System"> <d2p1:DateTime>2025-08-26T17:28:42.3918256Z</d2p1:DateTime> <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes> </DialogDate> <Name>sample string 2</Name> <Location>sample string 3</Location> <Agenda>sample string 4</Agenda> <SiteID>76e19618-f1e2-4c52-aa7b-6df7473ec08f</SiteID> <AncestorType>64</AncestorType> <Deleted>true</Deleted> <DeletedByRef>true</DeletedByRef> <Created>2025-08-26T17:28:42.3918256+00:00</Created> <CreatedBy>f45360af-b90c-48f0-9d6c-a513739d0138</CreatedBy> <Updated>2025-08-26T17:28:42.3918256+00:00</Updated> <UpdatedBy>a6bc1e4c-b993-4d1c-b634-f3b71b86d16d</UpdatedBy> <Template>true</Template> <Draft>true</Draft> <LastCommentDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System"> <d2p1:DateTime>2025-08-26T17:28:42.3918256Z</d2p1:DateTime> <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes> </LastCommentDate> <LastCommentByID>6af5d524-921e-4934-b483-0724d2b6dadc</LastCommentByID> <LastCommentBy>sample string 5</LastCommentBy> <LastComment>sample string 6</LastComment> <CanRead>true</CanRead> <CanUpdate>true</CanUpdate> <CanDelete>true</CanDelete> <CanDelegate>true</CanDelegate> <RowType>1</RowType> <DialogOccurred>true</DialogOccurred> </Dialog>
{ "ID": "90e7ebf4-397d-47ee-aaaf-b33b5717ec1c", "AncestorID": "0cb9c05e-e833-4364-8a20-4f4c9601febf", "DialogDate": "2025-08-26T17:28:42.3918256+00:00", "Name": "sample string 2", "Location": "sample string 3", "Agenda": "sample string 4", "SiteID": "76e19618-f1e2-4c52-aa7b-6df7473ec08f", "AncestorType": 64, "Deleted": true, "DeletedByRef": true, "Created": "2025-08-26T17:28:42.3918256+00:00", "CreatedBy": "f45360af-b90c-48f0-9d6c-a513739d0138", "Updated": "2025-08-26T17:28:42.3918256+00:00", "UpdatedBy": "a6bc1e4c-b993-4d1c-b634-f3b71b86d16d", "Template": true, "Draft": true, "LastCommentDate": "2025-08-26T17:28:42.3918256+00:00", "LastCommentByID": "6af5d524-921e-4934-b483-0724d2b6dadc", "LastCommentBy": "sample string 5", "LastComment": "sample string 6", "CanRead": true, "CanUpdate": true, "CanDelete": true, "CanDelegate": true, "RowType": 1, "DialogOccurred": true }