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>a2bf5cf4-c3d3-4726-8c24-376b3d5ea6a6</SiteID>
  <StartDate>2026-02-20T15:23:22.5785162+00:00</StartDate>
  <EndDate>2026-02-20T15:23:22.5785162+00:00</EndDate>
</Period>

application/json, text/json

Sample

,"Permissions":0,"ID":1,"SiteID":"a2bf5cf4-c3d3-4726-8c24-376b3d5ea6a6","StartDate":"2026-02-20T15:23:22.5785162+00:00","EndDate":"2026-02-20T15:23:22.5785162+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>2477efff-2f81-4893-97c2-fbd7e73b6ed1</SiteID>
  <StartDate>2026-02-20T15:23:22.5785162+00:00</StartDate>
  <EndDate>2026-02-20T15:23:22.5785162+00:00</EndDate>
</Period>

application/json, text/json

Sample

{
  "TotalProjects": 1,
  "TotalCommitments": 1,
  "DateSpan": "sample string 5",
  "Permissions": 6,
  "ID": 1,
  "SiteID": "2477efff-2f81-4893-97c2-fbd7e73b6ed1",
  "StartDate": "2026-02-20T15:23:22.5785162+00:00",
  "EndDate": "2026-02-20T15:23:22.5785162+00:00"
}