POST periods

Request Information

URI Parameters

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

None.

Body Parameters (Period)

Contains the dates needed to create a new period.

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

Name	Description
ID `integer` Required on Update ID of the given period.	`integer` Required on Update ID of the given period.
SiteID `globally unique identifier` Required on Create ID of the site for the given period.	`globally unique identifier` Required on Create ID of the site for the given period.
StartDate `date` Required Start date of the given period.	`date` Required Start date of the given period.
EndDate `date` Required End date of the given period.	`date` Required End date of the given period.
TotalProjects `integer` ReadOnly Total number of projects for the given period.	`integer` ReadOnly Total number of projects for the given period.
TotalCommitments `integer` ReadOnly Total number of commitments for the given period.	`integer` ReadOnly Total number of commitments for the given period.
DateSpan `string` ReadOnly Span of dates for the given period.	`string` ReadOnly Span of dates for the given period.
Permissions `integer` ReadOnly Permissions for the given period.	`integer` ReadOnly Permissions for the given period.

Request Formats

application/xml, text/xml

Sample

<Period xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <Permissions>0</Permissions>
  <ID>1</ID>
  <SiteID>76d80c43-c5c6-4584-8777-49fa65b9dd01</SiteID>
  <StartDate>2025-11-23T18:41:36.0584633+00:00</StartDate>
  <EndDate>2025-11-23T18:41:36.0584633+00:00</EndDate>
</Period>

application/json, text/json

Sample

,"Permissions":0,"ID":1,"SiteID":"76d80c43-c5c6-4584-8777-49fa65b9dd01","StartDate":"2025-11-23T18:41:36.0584633+00:00","EndDate":"2025-11-23T18:41:36.0584633+00:00"}

Response Information

Resource Description (Period)

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

Name	Description
ID `integer` Required on Update ID of the given period.	`integer` Required on Update ID of the given period.
SiteID `globally unique identifier` Required on Create ID of the site for the given period.	`globally unique identifier` Required on Create ID of the site for the given period.
StartDate `date` Required Start date of the given period.	`date` Required Start date of the given period.
EndDate `date` Required End date of the given period.	`date` Required End date of the given period.
TotalProjects `integer` ReadOnly Total number of projects for the given period.	`integer` ReadOnly Total number of projects for the given period.
TotalCommitments `integer` ReadOnly Total number of commitments for the given period.	`integer` ReadOnly Total number of commitments for the given period.
DateSpan `string` ReadOnly Span of dates for the given period.	`string` ReadOnly Span of dates for the given period.
Permissions `integer` ReadOnly Permissions for the given period.	`integer` ReadOnly Permissions for the given period.

Response Formats

application/xml, text/xml

Sample

<Period xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <DateSpan>sample string 5</DateSpan>
  <Permissions>6</Permissions>
  <TotalCommitments>1</TotalCommitments>
  <TotalProjects>1</TotalProjects>
  <ID>1</ID>
  <SiteID>925a43d9-57dc-4e38-a996-44bbc49d7c51</SiteID>
  <StartDate>2025-11-23T18:41:36.0896734+00:00</StartDate>
  <EndDate>2025-11-23T18:41:36.0896734+00:00</EndDate>
</Period>

application/json, text/json

Sample

{
  "TotalProjects": 1,
  "TotalCommitments": 1,
  "DateSpan": "sample string 5",
  "Permissions": 6,
  "ID": 1,
  "SiteID": "925a43d9-57dc-4e38-a996-44bbc49d7c51",
  "StartDate": "2025-11-23T18:41:36.0896734+00:00",
  "EndDate": "2025-11-23T18:41:36.0896734+00:00"
}