Use this call to change or reset the current period in Anaplan.

This enables an integration to advance or change the model calendar as part of a scheduled planning, forecasting, or period-close process.

When this call contains a specified date (for example, 2020-05-20), the API determines what period range contains the specified data and sets that range as the current period.  When the date value is set to blank in this call, the API resets the current period to blank.

Warning: A change to your time settings is a potentially destructive action and may lead to data loss.  The new range of time periods may not include previous time periods. Any data in the removed time periods is deleted from the model.

Note: To use this call, you must be a Workspace Administrator

PUT

/workspaces/{workspaceId}/models/{modelId}/currentPeriod

BodyDetails
{date}
  • Required
  • Type: String
  • Description: The date to use to set, or reset, the current period. The date format is YYYY-MM-DD.
    If the date parameter is left blank (for example, /currentperiod?date=) the current period resets.
    If the date is not provided in the YYYY-MM-DD format, the call returns a 400 Bad Request response with this message: Invalid ISO date format '{date}'. Date should match format YYYY-MM-DD
    If this value falls outside of a valid range, the call returns a 400 Bad Request response with this message: Specified date '{date}' is out of timescale range {start of timescale} - {end of timescale}.
  • Example: 2010-05-20

curl -X PUT https://api.anaplan.com/2/0/workspaces/{workspaceId}/models/{modelId}/currentPeriod\
-H 'Accept: application/json' \
-H 'Authorization: AnaplanAuthToken {anaplan_auth_token}' \
-H 'Content-Type: application/json'

Content-Type: application/json

{
   "meta":{
      "schema":"https://api.anaplan.com/2/0/objects/currentPeriod"
   },
   "status":{
      "code":200,
      "message":"Success"
   },
   "currentPeriod":{
      "periodText":"May 20",
      "lastDay":"2020-05-31",
      "calendarType":"Calendar Months/Quarters/Years"
   }
}