Update a dialog.
id
globally unique identifier
Required
Guid ID of the dialog to be updated. |
tz
string
Optional parameter to set timezone information. |
This object takes all the parameters needed to update a dialog.
System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList
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>3c97f67a-8a53-4fdc-a1a6-a81c4ad457a2</ID> <AncestorID>fb60ca4c-910f-4b3c-86b2-d066a5767f90</AncestorID> <DialogDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System"> <d2p1:DateTime>2025-10-01T11:29:57.6683015Z</d2p1:DateTime> <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes> </DialogDate> <Name>sample string 2</Name> <Location>sample string 3</Location> <Agenda>sample string 4</Agenda> <DialogOccurred>true</DialogOccurred> </Dialog>
{ "ID": "3c97f67a-8a53-4fdc-a1a6-a81c4ad457a2", "AncestorID": "fb60ca4c-910f-4b3c-86b2-d066a5767f90", "DialogDate": "2025-10-01T11:29:57.6683015+00:00", "Name": "sample string 2", "Location": "sample string 3", "Agenda": "sample string 4", "DialogOccurred": true }
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>a3012285-851f-4da0-9cdf-7b5a7787afc8</ID> <AncestorID>08d3cba7-ca16-4c31-8b66-4ed412131493</AncestorID> <DialogDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System"> <d2p1:DateTime>2025-10-01T11:29:57.6797331Z</d2p1:DateTime> <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes> </DialogDate> <Name>sample string 2</Name> <Location>sample string 3</Location> <Agenda>sample string 4</Agenda> <SiteID>d3fa72ac-ba70-4beb-a624-e04eb8549535</SiteID> <AncestorType>64</AncestorType> <Deleted>true</Deleted> <DeletedByRef>true</DeletedByRef> <Created>2025-10-01T11:29:57.6797331+00:00</Created> <CreatedBy>1d80c207-11ee-4840-a971-fd38f13be45a</CreatedBy> <Updated>2025-10-01T11:29:57.6797331+00:00</Updated> <UpdatedBy>4111c56b-b6cb-4461-b83e-7b140f874c79</UpdatedBy> <Template>true</Template> <Draft>true</Draft> <LastCommentDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System"> <d2p1:DateTime>2025-10-01T11:29:57.6797331Z</d2p1:DateTime> <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes> </LastCommentDate> <LastCommentByID>056f60cf-ef09-45ac-b7ae-80cef8d2e115</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": "a3012285-851f-4da0-9cdf-7b5a7787afc8", "AncestorID": "08d3cba7-ca16-4c31-8b66-4ed412131493", "DialogDate": "2025-10-01T11:29:57.6797331+00:00", "Name": "sample string 2", "Location": "sample string 3", "Agenda": "sample string 4", "SiteID": "d3fa72ac-ba70-4beb-a624-e04eb8549535", "AncestorType": 64, "Deleted": true, "DeletedByRef": true, "Created": "2025-10-01T11:29:57.6797331+00:00", "CreatedBy": "1d80c207-11ee-4840-a971-fd38f13be45a", "Updated": "2025-10-01T11:29:57.6797331+00:00", "UpdatedBy": "4111c56b-b6cb-4461-b83e-7b140f874c79", "Template": true, "Draft": true, "LastCommentDate": "2025-10-01T11:29:57.6797331+00:00", "LastCommentByID": "056f60cf-ef09-45ac-b7ae-80cef8d2e115", "LastCommentBy": "sample string 5", "LastComment": "sample string 6", "CanRead": true, "CanUpdate": true, "CanDelete": true, "CanDelegate": true, "RowType": 1, "DialogOccurred": true }