Back

PUT periods/{id}

Update a performance period. PMAdmin

Request Information

URI Parameters

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

ID of the period to be updated.

Body Parameters (Period)

Contains the parameters needed to update a period.

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList
ID integer Required on Update

ID of the given period.
SiteID globally unique identifier Required on Create

ID of the site for the given period.
StartDate date Required

Start date of the given period.
EndDate date Required

End date of the given period.
TotalProjects integer ReadOnly

Total number of projects for the given period.
TotalCommitments integer ReadOnly

Total number of commitments for the given period.
DateSpan string ReadOnly

Span of dates for the given period.
Permissions 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>1fa9172b-2bae-4eb7-b1bf-78645e094842</SiteID>
  <StartDate>2026-01-27T01:46:45.5207508+00:00</StartDate>
  <EndDate>2026-01-27T01:46:45.5207508+00:00</EndDate>
</Period>

application/json, text/json

Sample
,"Permissions":0,"ID":1,"SiteID":"1fa9172b-2bae-4eb7-b1bf-78645e094842","StartDate":"2026-01-27T01:46:45.5207508+00:00","EndDate":"2026-01-27T01:46:45.5207508+00:00"}

Response Information

Resource Description (Period)

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList
ID integer Required on Update

ID of the given period.
SiteID globally unique identifier Required on Create

ID of the site for the given period.
StartDate date Required

Start date of the given period.
EndDate date Required

End date of the given period.
TotalProjects integer ReadOnly

Total number of projects for the given period.
TotalCommitments integer ReadOnly

Total number of commitments for the given period.
DateSpan string ReadOnly

Span of dates for the given period.
Permissions 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>9b7c9859-856a-40d5-a89e-e545e1812e3c</SiteID>
  <StartDate>2026-01-27T01:46:45.5207508+00:00</StartDate>
  <EndDate>2026-01-27T01:46:45.5207508+00:00</EndDate>
</Period>

application/json, text/json

Sample
{
  "TotalProjects": 1,
  "TotalCommitments": 1,
  "DateSpan": "sample string 5",
  "Permissions": 6,
  "ID": 1,
  "SiteID": "9b7c9859-856a-40d5-a89e-e545e1812e3c",
  "StartDate": "2026-01-27T01:46:45.5207508+00:00",
  "EndDate": "2026-01-27T01:46:45.5207508+00:00"
}