PUT dialogs/{id}?tz={tz}

Request Information

URI Parameters

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList

Name	Description
id `globally unique identifier` Required Guid ID of the dialog to be updated.	`globally unique identifier` Required Guid ID of the dialog to be updated.
tz `string` Optional parameter to set timezone information.	`string` Optional parameter to set timezone information.

Body Parameters (Dialog)

This object takes all the parameters needed to update a dialog.

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList

Request Formats

application/xml, text/xml

Sample

<Dialog xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>727dcc8d-cb75-448a-8aac-76b723d8c0cb</ID>
  <AncestorID>85f2dc74-1e4b-4bbd-acc6-6a1efb812c50</AncestorID>
  <DialogDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-03-06T17:37:46.8111368Z</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>

application/json, text/json

Sample

{
  "ID": "727dcc8d-cb75-448a-8aac-76b723d8c0cb",
  "AncestorID": "85f2dc74-1e4b-4bbd-acc6-6a1efb812c50",
  "DialogDate": "2025-03-06T17:37:46.8111368+00:00",
  "Name": "sample string 2",
  "Location": "sample string 3",
  "Agenda": "sample string 4",
  "DialogOccurred": true
}

Response Information

Resource Description (Dialog)

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList

Response Formats

application/xml, text/xml

Sample

<Dialog xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>a6ef4005-ecd4-4ed1-af4c-ef4208b18b02</ID>
  <AncestorID>59420b50-0e3c-4a93-899b-575b17aaeadf</AncestorID>
  <DialogDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-03-06T17:37:46.8267611Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </DialogDate>
  <Name>sample string 2</Name>
  <Location>sample string 3</Location>
  <Agenda>sample string 4</Agenda>
  <SiteID>bb93c231-e8d1-4bf1-9108-5d1b8387f7e9</SiteID>
  <AncestorType>64</AncestorType>
  <Deleted>true</Deleted>
  <DeletedByRef>true</DeletedByRef>
  <Created>2025-03-06T17:37:46.8267611+00:00</Created>
  <CreatedBy>e3ac4a17-87ed-451e-a6e9-c246c9a9fd97</CreatedBy>
  <Updated>2025-03-06T17:37:46.8267611+00:00</Updated>
  <UpdatedBy>429bfb59-e9e2-49d9-a3e3-dc0b53187db8</UpdatedBy>
  <Template>true</Template>
  <Draft>true</Draft>
  <LastCommentDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-03-06T17:37:46.8267611Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </LastCommentDate>
  <LastCommentByID>fa2a41ae-6380-4882-8953-de6b29996833</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>

application/json, text/json

Sample

{
  "ID": "a6ef4005-ecd4-4ed1-af4c-ef4208b18b02",
  "AncestorID": "59420b50-0e3c-4a93-899b-575b17aaeadf",
  "DialogDate": "2025-03-06T17:37:46.8267611+00:00",
  "Name": "sample string 2",
  "Location": "sample string 3",
  "Agenda": "sample string 4",
  "SiteID": "bb93c231-e8d1-4bf1-9108-5d1b8387f7e9",
  "AncestorType": 64,
  "Deleted": true,
  "DeletedByRef": true,
  "Created": "2025-03-06T17:37:46.8267611+00:00",
  "CreatedBy": "e3ac4a17-87ed-451e-a6e9-c246c9a9fd97",
  "Updated": "2025-03-06T17:37:46.8267611+00:00",
  "UpdatedBy": "429bfb59-e9e2-49d9-a3e3-dc0b53187db8",
  "Template": true,
  "Draft": true,
  "LastCommentDate": "2025-03-06T17:37:46.8267611+00:00",
  "LastCommentByID": "fa2a41ae-6380-4882-8953-de6b29996833",
  "LastCommentBy": "sample string 5",
  "LastComment": "sample string 6",
  "CanRead": true,
  "CanUpdate": true,
  "CanDelete": true,
  "CanDelegate": true,
  "RowType": 1,
  "DialogOccurred": true
}

Name	Description
ID `globally unique identifier` Required on Update ID of the given Dialog.	`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.	`globally unique identifier` Required on Create ID of the ancestor of the given dialog.
DialogDate `date` Required Date the given dialog was created.	`date` Required Date the given dialog was created.
Name `string` Name of the given dialog. (Max length 255 characters)	`string` Name of the given dialog. (Max length 255 characters)
Location `string` Location of the given dialog. (Max length 50 characters)	`string` Location of the given dialog. (Max length 50 characters)
Agenda `string` Agenda of the given dialog.	`string` Agenda of the given dialog.
SiteID `globally unique identifier` ReadOnly ID of the site for the given dialog.	`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.	`byte` ReadOnly Ancestor type (organization, individual, project, or task) of the given dialog.
Deleted `boolean` ReadOnly Deleted status of the given dialog.	`boolean` ReadOnly Deleted status of the given dialog.
DeletedByRef `boolean` ReadOnly Deleted by reference status of the given dialog.	`boolean` ReadOnly Deleted by reference status of the given dialog.
Created `date` ReadOnly Date that the given dialog was created.	`date` ReadOnly Date that the given dialog was created.
CreatedBy `globally unique identifier` ReadOnly ID of the individual that created the given dialog.	`globally unique identifier` ReadOnly ID of the individual that created the given dialog.
Updated `date` ReadOnly Date the given dialog was last 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.	`globally unique identifier` ReadOnly ID of the individual that last updated the given dialog.
Template `boolean` ReadOnly Indicates the given dialog is a template.	`boolean` ReadOnly Indicates the given dialog is a template.
Draft `boolean` ReadOnly Indicates the given dialog is a Draft.	`boolean` ReadOnly Indicates the given dialog is a Draft.
LastCommentDate `date` ReadOnly Date of the most recent comment for the given dialog.	`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.	`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.	`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.	`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.	`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.	`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.	`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.	`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,	`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.	`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.