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>5d441370-0e6e-4036-9b39-f05002765f1c</SiteID>
  <StartDate>2024-10-23T22:07:49.2746564+00:00</StartDate>
  <EndDate>2024-10-23T22:07:49.2746564+00:00</EndDate>
</Period>

application/json, text/json

Sample

,"Permissions":0,"ID":1,"SiteID":"5d441370-0e6e-4036-9b39-f05002765f1c","StartDate":"2024-10-23T22:07:49.2746564+00:00","EndDate":"2024-10-23T22:07:49.2746564+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>520f4791-ce3a-4791-8e63-5c54435c800f</SiteID>
  <StartDate>2024-10-23T22:07:49.2746564+00:00</StartDate>
  <EndDate>2024-10-23T22:07:49.2746564+00:00</EndDate>
</Period>

application/json, text/json

Sample

{
  "TotalProjects": 1,
  "TotalCommitments": 1,
  "DateSpan": "sample string 5",
  "Permissions": 6,
  "ID": 1,
  "SiteID": "520f4791-ce3a-4791-8e63-5c54435c800f",
  "StartDate": "2024-10-23T22:07:49.2746564+00:00",
  "EndDate": "2024-10-23T22:07:49.2746564+00:00"
}