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>b25c8b7d-fd18-452c-8de1-4834288c990d</SiteID>
  <StartDate>2025-12-24T05:48:38.8849521+00:00</StartDate>
  <EndDate>2025-12-24T05:48:38.8849521+00:00</EndDate>
</Period>

application/json, text/json

Sample

,"Permissions":0,"ID":1,"SiteID":"b25c8b7d-fd18-452c-8de1-4834288c990d","StartDate":"2025-12-24T05:48:38.8849521+00:00","EndDate":"2025-12-24T05:48:38.8849521+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>6194f841-7cc2-496c-962d-bdf303965dcc</SiteID>
  <StartDate>2025-12-24T05:48:38.8849521+00:00</StartDate>
  <EndDate>2025-12-24T05:48:38.8849521+00:00</EndDate>
</Period>

application/json, text/json

Sample

{
  "TotalProjects": 1,
  "TotalCommitments": 1,
  "DateSpan": "sample string 5",
  "Permissions": 6,
  "ID": 1,
  "SiteID": "6194f841-7cc2-496c-962d-bdf303965dcc",
  "StartDate": "2025-12-24T05:48:38.8849521+00:00",
  "EndDate": "2025-12-24T05:48:38.8849521+00:00"
}