API Changes by Release
2025R1
(February 2025)
JSON Formatted REST APIs
- Tasks Service
- Tasks
- /tasks?instanceCode=<instanceCode>(GET, POST)JSON based HTTP operations on integration tasks.
2024R2
(September 2024)
Introduction of API v40
- Updated:importModeledSheetnow supports the optionalaccountCodeattribute within theDisplayColumnselement. Thecodeattribute ofDisplayColumnnow enables creating an editable unique identifier for the column. WhenaccountCodeisn't included in the request, we procedurally generate a uniquecodeto link the column to a given account.
- Updated:exportModeledSheetnow supports the optionalaccountCodeattribute within theDisplayColumnselement. Thecodeattribute ofDisplayColumnnow enables creating an editable unique identifier for the column.
- updated:importConfigurableModelDatacorrectedapplyValidationRulesdescription to indicate the default value istrue, and has been since v38.
- updated:importStandardDatanow supportssplitsToUnsplitin theimportDataOptionselement, allowing splits to import into unsplit locations with existing data.
- updated:exportCalendarnow supportscodein thecalendarelement.
- updated:exportVersionsnow supportscurrencyVersionsin theincludeelement. This enables including currency versions for translated actuals in the response. You must contact your Named Support Contact to see if your instance is eligible for this feature.
JSON Formatted REST APIs
- Modeling Service
- Time
- /updateTimethe Calendar Object now supportscodewhen codes are present.
- Modeled Sheet Definition
- /definitionPATCHsupportsaccountCodein the sheet column properties object to determine the modeled account for a display column. Only valid for display columns. The only valid values are accounts on the modeled sheet.
- /definitionPATCHsupportscodein the sheet column properties object to prefix account codes and a secondary identifier. Required when creating a new sheet. This functions the same asprefixand is the preferred property to match the user interface.
2024R1
(April 2024)
- Regional authentication for non-US based tenants:Based on the location of your Adaptive Planning instance, your authorization URLs and API endpoints can vary. For more information, see Adaptive Planning Authentication URLs and IP Addresses.
(March 2024)
Introduction of API v39
- Updated:exportDatano longer supports thesheetelement in API v39 and above.
- Updated:exportDatasupports:
- All elements and attributes for the optimized path for performance and scalability for API v39 and above.
- Accounts with weighted average rollup for performance and scalability for API v39 and above.
- Updated:exportAttributessupports acodeattribute for theattributeelement. Thecodeattribute is only available in API v39 and above.
- Updated:updateAttributessupports acodeattribute for theattributeelement. Thecodeattribute is only available in API v39 and above.
- Updated:exportDimensionssupports acodeattribute for thedimensionelement. Thecodeattribute is only available in API v39 and above.
- Updated:updateDimensionssupports acodeattribute for thedimensionelement. Thecodeattribute is only available in API v39 and above.
- Updated:exportAccountssupports a new BooleanshowAccountGroupCodesattribute in theincludeelement. Setting this attribute to true in requests exports account group codes in the response. TheshowAccountGroupCodesattribute is only available in API v38 and above.
- Updated:importModeledSheetrequires anameandcodeattribute in theconfigurableModelelement of requests. thenameandcodeelements are only available in API v39 and above.
- Updated:exportSheetswe rename theprefixattribute tocodein themodeled-sheetelement. Thecodeis only available in API v39 and above.
- Updated:exportVersionssupports the Booleanscenariosattribute in theincludeelement of requests to returntype="SCENARIO"for personal what-if scenarios in the response. Requires API v37 and above.
- Updated:importGroupssupports editing external user groups in the Adaptive Planning user interface when those user groups havedataSource=EXTERNAL.
- Updated:createUsersupports these attributes in theuserelement:
- position
- homepage
- country
- usState
- netSuiteLogin
- salesforceLogin
- Updated:updateUsersupports these attributes in theuserelement:
- position
- homepage
- country
- usState
- perspective
- perspectiveName
- dashboard
- dashboardName
- netSuiteLogin
- salesforceLogin
- Updated:exportUserssupports these attributes in theuserelement:
- alternateEmail
- samlFedId
- position
- homepage
- country
- usState
- perspective
- perspectiveName
- dashboard
- dashboardName
- nestuiteLogin
- salesforceLogin
- createdDate
- lastLogin
- failedAttempts
- Locked
JSON Formatted REST APIs
- Modeling Service
- Modeled Sheet Definition
- /sheet/modeled/definitionPATCHsupportsdeleteas a property in the sheet column object to delete modeled sheet columns in Adaptive Planning. Delete can't delete:
- Required columns.
- Columns dependent on other columns that aren't flagged for deletion.
- Cube Sheet Definition
- /sheet/cube/definition(PATCH,DELETE) Insert, update, or delete a cube sheet definition in Adaptive Planning.
- /sheet/cube/definitionPATCHsupportsdeleteas a property in the sheet column object to delete cube sheet columns in Adaptive Planning. Delete can't delete:
- Columns dependent on other columns that aren't flagged for deletion.
- Introduction of APIs that only support deleting:
- Accounts
- /accounts/removeGLAccounts(POST) Deletes general ledger accounts.
- /accounts/removeAccounts(POST) Deletes custom accounts.
- Attribute
- /attribute(DELETE) Deletes an attribute and its attribute values.
- Attribute Values
- /removeAttributeValues(POST) Deletes attribute values.
- Dimension
- /dimension(DELETE) Deletes a dimension and its dimension values.
- Dimension Values
- /removeDimensionValues(POST) Deletes dimension values.
- Level
- /removeLevels(POST) Deletes levels.
- Security Service
- Groups:
- /groups(GET) Retrieve the complete list of all groups defined for the given instance.
- Users
- /users(DELETE) Delete the user from Adaptive Planning.
2023R2
(December 8)
- Updated:importConfigurableModelDatasupportsapplyValidationRulesin theimportDataOptionselement for indicating if data imports validate against validation rules.
Introduction of API v37
- Updated:customReportValuessupports a newcell-inclusionsattribute in thereportelement. This attribute works at the cell level in conjunction withsuppress-zeroesto control whether the output contains zero or blank cells or not for unsuppressed rows.
- Updated:customReportValuesandexportDatareceive performance improvements under specific conditions. See:
2023R1
(March 11)
Introduction of API v36
- Updated:importStandardDatasupportsmodein the importDataOptions element for indicatingREPLACEmode.
- Updated:importStandardDatarequires thescopeelement when usingreplacemode to indicate the data being replaced. Thescopeelement requires 1timeelement, 1accountselement with at least 1 childaccountelement, and 1levelselement.
- Updated: Users makingimportStandardDatarequests require Erase Data permissions for API v36 to supportREPLACEmode.
JSON Formatted APIs
- Modeling Service:
- Currency:
- /currency(POST,DELETE) Create, update, or delete currencies in Adaptive Planning.
- Exchange Rate Type:
- /exchangeRateTypes(GET,POST,DELETE) Insert, update, or delete exchange rate types in Adaptive Planning.
- Sheet:
- /sheet/modeled/definition(PATCH,DELETE) Insert, update, or delete a modeled sheet definition in Adaptive Planning.
- Versions:
- /versions(GET,DELETE,PATCH,POST) Retrieve, delete, update, or create versions in Adaptive Planning.
- Time:
- /updateTime(POST) Reload, update, append the time structure in Adaptive Planning.
2022R2
(November 18, 2022)
Introduction of API v35
- Updated:exportConfigurableModelDatastreaming supportsuseActualValueas an attribute in the requestmodeled-sheetelement to return raw data instead of account precision. Calculated accounts return at 9-decimal precision.
- Updated:exportConfigurableModelDatasupports a newstatuselement in theresponseelement. Thestatuselement includes asuccessBoolean attribute followed byrowCountSentto indicate rows sent when successful or not.
- Updated:exportConfigurableModelDatasupportstotalRowCountin the response outputdataelement to indicate total rows indata.
- Updated:exportConfigurableModelDataautomatically escapes double quotes in string values for dimension values and text fields in the response output.
- Removed:successattribute in theresponseelement ofexportConfigurableModelDatais removed by default for API v35 when streaming data (isGetAllRows="true").
- Removed: The prefixsforparentIdin the data output whenuseNumericIDs=trueis removed for API v35 when streaming data (isGetAllRows="true").
(September 2022)
Introduction of API v34
- Updated:updateAccountssupports tagging dimension values and attributes values by only usingvalue. No longer supportsvalueNameandvalueCodewith API v34.
- Updated:updateDimensionssupports tagging dimension values and attributes values by only usingvalue. No longer supportsvalueNameandvalueCodewith API v34.
- Updated:updateLevelssupports tagging dimension values and attributes values by only usingvalue. No longer supportsvalueNameandvalueCodewith API v34.
- Updated:exportAccountsindicates tagged dimension values and attributes values withvalue. No longer supportsvalueNameandvalueCodewith API v34.
- Updated:exportDimensionsindicates tagged dimension values and attributes values withvalue. No longer supportsvalueNameandvalueCodewith API v34.
- Updated:exportLevelsindicates tagged dimension values and attributes values withvalue. No longer supportsvalueNameandvalueCodewith API v34.
- Updated:updateAccountsrequests can setbalanceTypeas eitherdebitorcredit. Child accounts can now use a differentbalanceTypethan their parent accounts to support contra accounts.
- Updated:updateAccountsresponses include a new boolean property forisContrato indicate if the account is a contra account.
- Updated:createAccountresponses include a new boolean property forisContrato indicate if the account is a contra account.
- Updated:exportSheetDefinitionreturnshorizontalAxis,verticalAxis,maxColumnWidth,suppressZeroRows,rearreangeGLAndCustomAccounts,hideRollupTotalsin thecube-sheetelement.
- Updated:exportSheetDefinitionreturns theusersanduserelements in the response if the calling user has the Model permission.
- Updated:importCubeDatasupportsmodein theimportDataOptionselement for indicating eitherAPPENDorREPLACEimport mode.
- Updated:importCubeDatasupports thescopeelement when usingREPLACEimport mode to indicate the coordinates of the cube where data will be replaced.
(August 2022)
Introduction of API v33
- New:exportCalendarsupports exporting calendar metadata with the introduction of alternate calendars in 2022R2.
- Updated:exportTimesupportscalendarIdin the options element to retrieve the time values from any of your calendars with the introduction of alternate calendars in 2022R2.
- Updated:exportConfigurableModelDatanow supports exporting only the columns of interest if you specify them in thefilterselement of the request.
- Updated:exportConfigurableModelDatanow supports outputting number columns at the account decimal precision by settinguseAccountPrecision=truefor themodeled-sheetelement whenisGetAllRows=true.
2022R1
(May 2022)
- Updated:updateLevelssupports a flat input format allowingleveltags to sit directly beneath alevelstag. This input format is only recommended for incremental changes to small portions of the levels hierarchy.
(March 2022)
- New:importGroups: for importing a set of user groups.
Introduction of JSON formatted APIs Version 1
- Modeling Service:
- sheet/availability(GET,POST) Retrieve or update dimension or attribute value availability for a given sheet and column.
- Security Service:
- users/permissionSets(GET,POST) Assign permission sets to Adaptive Planning users.
- users/instances(GET,PATCH,PUT) Assign users to instances when using Adaptive Planning multi-instances in a parent-child hierarchy.
(February 2022)
Introduction of API v32
- Updated:exportConfigurableModelDatastreams data for better performance.
- Updated:updateLevelsnow supportsvalueCodeandvalueNamein thedimensionelement when display names are enabled.
- Updated:updateDimensions,updateLevels, andupdateAccountsnow supportvalueCodeandvalueNamein theattributeelement when display names are enabled.
- Updated:exportDimensions,exportLevels, andexportAccountsnow supportvalueCode,valueName, andvalueDisplayNamein theattributeelement when display names are enabled.
2021R2
(October 2021)
- You enable display names for your instance by opening a case in the Workday Customer Center.
- You call API v30 or higher.
- You enabledisplayNameEnabledper call (see each API documentation page for details).
- Updated:updateLevels,updateDimensions,updateAttributesrequests now acceptcodeandnameand continue to useidas the key.
- codeandnameare required when you create dimension values, attribute values, and levels.
- Updated:updateLevels,updateDimensions,updateAttributesresponses now returnname,code,displayNameanddisplayNameType.
- Updated:importDimensionMappingrequests accept:
- idandnamefordimension.
- idandcodefor levels and dimension values.
- Updated:exportDimensionMappingrequests filtering:
- keywordvalue as a partial match on the display name.
- levelusescodeinstead ofname.
- dimensionValueusescodeinstead ofname.
- Attributevaluerefers tocode, instead ofname.
- Updated:exportDimensionMappingresponses returnid,name,code,display namefor levels and dimension values.
- Updated:exportLevels,exportDimensions, andexportAttributesresponses now returnname,code,displayName,displayNameType.
- Updated:importStandardData,importCubeData,importConfigurableModelData, andimportTransactionsrequest:
- Header rowLevelchanges toLevel Code.
- Header rowAccountchanges toAccount Code.
- Header rowDimensionschange to"<dimension> Code"and"<dimension> Name"."<dimension> Code"is required."<dimension> Name"is only allowed when "Data import automatically creates dimension values" is enabled for a dimension.
- Localization is supported in the column header for the text "Code", "Name", and "Display Name".
- useMappings=falseuses code in the system.
- useMappingsanddisplayNameEnabledcan't betrueat the same time.
- Updated:exportConfigurableModelData(requires API v31) requests :
- levelelement no longer supportsnamein API v31+.
- levelelement adds support forcode.
- modeled-sheetelement adds support forincludeCodes,includeNames, andincludeDisplayNameswith true/false options that apply to alldimension valuesandlevelsin the call. At least one of these three options must be true.
- Updated:exportConfigurableModelDataresponses:
- Includes columns for"<dimension> Code","<dimension> Name", and"<dimension> Display Name"
- Localization is supported on the column header for the text "Code", "Name", and "Display Name".
- Updated:exportDatarequests:
- levelelement no longer supportsnamein API v30+.
- levelelement adds support forcode.
- levelwill match code in the system.
- dimensionValueelement no longer supportsnamein API v30+.
- dimensionValueadds support forcode.
- dimensionValuewill match code in the system.
- Updated:exportDataresponses:
- Includes columns for"<dimension> Code","<dimension> Name", and"<dimension> Display Name"
- Includes columns for"<level> Code","<level> Name", and"<level> Display Name"
- Localization is supported on the column header for the text "Code", "Name", and "Display Name".
- Updated:eraseDatarequests:
- levelelement no longer supportsnamein API v30+.
- levelelement adds support forcode.
- levelwill match code in the system.
Introduction of API v31
(September 2021)
- Updated:importConfigurableModelData,importTransactions,importCubeData, andimportStandardDataerror out when the number of pipe characters in the header and the data don't match.
- Updated:updateAccessRulesnow requires theUserspermission to invoke it, instead of theAdminpermission.
- Updated:updateAccountsnow allows creating a new parent account between an existing parent and its child accounts.
(August 2021) Introduction of API v30
- Updated:updateAttributes,updateDimensions,updateLevelsno longer support Unicode white space characters withinnameandshortName. Refer to https://docs.oracle.com/javase/7/docs/api/java/lang/Character.html#isWhitespace(char) for disallowed white space characters. A single space is allowed between words innameandshortName.
2021R1
(May 2021) Introduction of API v29
- Updated:updateAccountsrequests now allow creating new accounts withdataEntryType=CUBE.Adaptive Planningautomatically calculates thedataEntryTypefor any non-leaf accounts. If the parentdataEntryTypeisCUBE, new accounts will default todataEntryType=CUBE. Otherwise, new accounts default todataEntryType=STANDARD. Changes todataEntryTypefor non-leaf accounts are ignored.
- Updated:UpdateAccountsresponses indicatedataEntryTypefor all leaf accounts as eitherCUBEorSTANDARD.
(April 2021) Introduction of API v28
- Updated:exportVersionsresponses now includeisPredictive=truein theversionelement to indicate predictive versions.
- Updated:createUserrequests now includealternateEmailandsamlFedId. UsealternateEmailto set an alternate email, which we automatically select as the user's email in the User Details section. UsesamlFedIdto include the SAML federation ID for the user for single sign-on.
- Updated:updateUserrequests now includealternateEmailandsamlFedId. UsealternateEmailto set an alternate email, which we automatically select as the user's email in the User Details section. UsesamlFedIdto include the SAML federation ID for the user for single sign-on.
(March 2021) Introduction of API v27
- Updated:updateAttributesandupdateDimensionsrequests includeretainExistingOrderfor indicating if the payload order is ignored to maintain the orderAdaptive Planningalready uses for hierarchies. If false, the order of the payload determines how Adaptive Planning will order elements.
- Updated:updateLevelsrequests now set the default value ofretainExistingOrderto 1.
- Updated:updateAccountsrequests now set the default value ofretainExistingOrderto 1.
- Updated:importModeledSheetrequests now includerequiredColumnfor indicating if a dimension value must be provided for users to save the modeled sheet. You must askAdaptive Planningsupport to enablerequiredColumnforimportModeledSheetrequests.
- Updated:exportModeledSheetresponses now includerequiredColumnfor indicating if a dimension value must be provided for users to save the modeled sheet.
Introduction of API v26
- Updated:updateAccountsandupdateLevelsrequests includeretainExistingOrderfor indicating if the payload order is ignored to maintain the orderAdaptive Planningalready uses for hierarchies. If false, the order of the payload determines how Adaptive Planning will order elements.
- Renamed: For all v26 APIs,permissionSetIdreplacesroleIdwith the renaming of Roles and Permissions to Permission Sets inAdaptive Planning.
- New:updateAssociationsfor setting user dimension and level associations. Alternatively sets user level ownership for levels whencodeis not included in the Association element.
- Removed:roleIDis no longer supported in APIs v26 and newer. APIs v25 and older continue to supportroleID.
2020R2
- (February 2021) Updated: eraseData requests ignore the case of theAccountsandLevelstags.
- (December 2020) Updated:updateDimensionsrequest replaces newline characters found in thedimensionValue nameof a payload with a blank space. Preceding or trailing newline characters in the name become spaces that get trimmed during payload processing.
- (December 2020) Updated:updateDimensionsrequest now handle multiple renames of the same entity in the sameupdateDimensionscall. This helps resolve an issue when names swap more than once in a remote system between synchronizations into Adaptive Planning.
Introduction of API v25
- Updated:exportDatarequest no longer includesincludeRollups. Request includes booleanincludeRollupAccountsfor account rollups andincludeRollupLevelsfor level rollups.
Introduction of API v24
- Updated:updateLevelsrequest includespublishCurrencyfor indicating the currency when publishing a Financial Plan to Workday Core Financials.
- Updated:exportLevelsresponse includespublishCurrencyfor indicating the currency when publishing a Financial Plan to Workday Core Financials.
- Updated:exportInstancesresponse includesnotificationTypefor indicating Workday tenant notification setting whenAdaptive Planningis set up for Workday.
- Updated:exportDatarequest includesstratumfor indicating the code of the time strata for the exported data. When specified, the start and end time periods must fall within the time strata. The time strata must be equal to or greater than the account with the highest time strata in the request.
- Updated:exportData:When includeZeroRows=false, rows with a combination of only blanks and zeroes will not output in the response, even if markBlanks=true.
- New:eraseDatafor erasing plan and actuals data. Provides the same capabilities aseraseActualsbut also includes the ability to erase Plan data, with additional control over specific account-plan combinations that are targets.
- New:updateAccessRulesfor updating access rules in-bulk by uploading a multipart xml document containing an .xslx formatted for the Access Rules template.
2020R1
Introduction of API v23
- Updated:importConfigurableModelDatarequest includesimportKeyfor indicating the dimension or level to map import rows to the modeled sheet rows you want to update.
- Updated:exportUsersandexportLevelsrequests can include the booleangroupsso that responses includegroupIds. GroupIdscontain a comma-separated list of all groups the level or user belongs to. Thegroupsattribute defaults tofalse.
- New: (Available only with sales planning.)exportDimensionMappingexport user-defined dimension mapping rules.
- New: (Available only with sales planning.)importDimensionMappingupdate existing user-defined dimension mapping rules.
2019.3
Introduction of API v22
- Updated:exportConfigurableModelDatarequest includes the new optional propertyuseNumericIDsto remove theSprefix from split IDs, returning only numeric values.
- If your company Transition to Access Rules for security,exportAccounts, exportActiveCurrencies, exportAttributes, exportDimensions, exportLevels, exportTime,andexportVersionswill only validate on API v22. The response will contain only what the user indicated in thecredentialselement has access to.
- Updated:updateDimensionsincludes the new optionalpropertieselement for adimensionValuethat can contain up to fivepropertyelements. Eachpropertyelement includes anameandvalue.The value must be numeric.
- Updated:exportDimensionsresponse includes the newpropertieselement.
- Updated:exportSheetDefinitioncube sheet response includes the accountcodeandnamewithin theaccountelement.
- Updated:exportSheetDefinitioncube sheet response includes the dimensionnamewithin thedimensionelement.
- Updated:exportSheetDefinitioncube sheet response includes the attributenamewithin theattributeelement.
- Updated:exportConfigurableModelDatarequest includes the new optionalincludeAllColumnsin themodeled-sheetelement so that the response includes all columns.
- Updated:exportConfigurableModelDataresponse now indicatesnumberOfPagesinstead ofpageCountin thejobelement.
- Updated:exportInstancesresponse now indicates if an instance allows Admin Publishing in theoptionsattribute.
- Removed:rootActualsis no longer supported forexportVersionsregardless of API version.
2019.2
- (September 2019) New:exportSecurityAuditreturns a report of all security events in a specified time range.
2019.1
Introduction of API v20
- Updated:exportInstancesincludesworkdayTenantId,workdayEnvironment,workdayUiUrl, andworkdayRestUrlinformation for instances with Workday Power of One enabled.
- New:updateAccountsfor updating/creating accounts in-bulk. Manage accounts and their properties. Allows reparenting of existing accounts.
- New:updateAttributesfor updating/creating attributes in-bulk. Manage attributes and their attribute values. Allows reparenting of existing attribute values.
- Updated:exportAttributesincludes the theautoCreateboolean property to indicate if importing dimensions, levels, accounts, or attributes automatically creates new attribute values not foundAdaptive Planning.
- Updated:exportInstancesincludesworkdayTenantID, workdayEnvironment, workdayUiUrl, workdayRestUrlfor instances with Workday Power of One enabled.
- Removed: Single-entity APIs forcreateDimension,updateDimension,createDimensionValue,updateDimensionValue,createLevel, andupdateLevel. Use the metadata bulk APIs ofupdateDimensionsandupdateLevelsfor single-entity creation or update in API v20 and beyond.
2018.3
Introduction of API v19
- New:updateLevelsfor updating/creating levels in-bulk. Manage levels and their attribute values. Allows reparenting of existing levels.
- New:exportConfigurableModelDatafor exporting modeled sheet rows.
2018.2
Introduction of API v18
- Removed:exportLevelsno longer containsinaccessibleLevelsattribute in the request. See the newinaccessibleValues.
- Removed:exportUsersno longer contains options forhiddenVersionsandownedLevels.
- Removed:exportAccountsno longer contains theformulaattribute.
- New:exportAccounts, exportAttributes,exportDimensions,andexportLevelsinclude the newinaccessibleValuesattribute in the request so that only users with the appropriate permissions can view inaccessible values.
- Updated:exportAccounts, exportAttributes, exportDimensions,andexportLevelsonly show accessible values by default. Only users with appropriate permissions can view inaccessible values.
- Updated:exportAccounts,exportDimensions,andexportLevels includeelementversionNameandversionIDattribute in the request call will only succeed if the user has access to the version.
- Updated:exportAccountsthe name "GL" is now "GL Accounts" to match how reports named this account.
- Updated:exportActiveCurrenciesresponse is now ordered bycode.
- Updated:exportTime versionelementoptionattribute for a single version in the request will only succeed if the user has access to the version.
2018.1
Introduction of API v17
- Removed:updateUserremoved from all API versions March 2018
- Updated:exportActiveCurrenciescontains auserDefinedattribute to identify which currencies are user-defined.
- New: APIupdateDimensionsfor updating/creating dimensions in-bulk by uploading an XML document
2017.3
Introduction of API v16
- Updated: response formats ofexportAccounts,createAccount,updatedAccountdisplay the time strata code of each account in thetimeStratumfield
- Updated:eraseActualsonly accepts time periods at the same time strata as the input account type for API v15 +
- Updated:eraseActualsuses the phrasing "time stratum" instead of "granularity"
- Updated: request format ofimportModeledSheetincludes optionalstrata-code
- Updated: response format ofexportModeledSheetincludes optionalstrata-code
- Added:inUseandisDefaultproperty tostratumelement inexportTime
- Added: optionalleafStratumIdproperty to the request format ofexportTime
- New: APIrecalculateSheetfor recalculating sheets that have theRecalculate on demandproperty
2017.2
Introduction of API v15
Companies are only upgraded from API v14 to API v15 if they import a custom calendar in the Time Administration UI.
- Removed: calendar-related attributes forexportInstancescalendarType, q1FirstMonth, lastMonthIsFY, firstDayOfWeek, periodAlgorithm, leapWeekPeriod,andextraPeriodQuarterattributes frominstanceelement
- Updated:exportTimesignificantly overhauled
- Updated:exportDatathe behavior ofstartandendattributes use time period codes instead of MMM-YYYY date strings.
- Updated:exportDataoutput date headers changed to time period codes.
- Updated:exportVersionsto replace attributesstartVerFY, completedValuesThruYr, completedValuesThruMon, completedValuesThruPer, startScrollYr, startScrollMon, startScrollPer, endVerFY, lockLeadingYr, lockLeadingMon, lockLeadingPer, leftScrollFY, startPlanYr, startPlanMon, startPlanPer, endPlanFYwithstartVer, endVer, startScroll, completedValuesThru, leftScroll, startPlan, endPlan, lockLeading
- Updated:importStandardData, importConfigurableModelData, importCubeDataaccept time period codes instead of MMM-YYYY date strings
- Updated:exportLevelsmodified the format of theavailableStartandavailableEndattributes output time period codes instead of MMM-YYYY date strings.
- Updated:eraseActualsbehavior of attributesstartandendto use time period codes instead of MMM-YYYY date strings
- New: APIexportLocalesfor exporting the locales from the Time Administration UI.
2017.1
Introduction of API v14
- Updated:customReportValuesincludes a new optional elementsuppress-rollups
- New: APIexportModeledSheet
- New: APIimportModeledSheet
2016.3
Introduction of API v13
- Updated:exportAccountsincludes a new optional elementsheet
- Updated:exportLevelsincludes a new optional elementsheet
- Updated:exportLevelsincludes a new optional response elementhasChildren
- Updated:exportVersionsincludes a new optional elementinclude
2016.2
Introduction of API v12
- Updated:importCubeData, importStandardData, importConfigurableData, importTransactionscontext information that is part of their error messages can be disabled using the attributeincludeContext.
2016.1
Introduction of API v11
- Removed:canBeTreeattribute fromexportDimensions
- Updated:exportInstancesincludes newdatasourcesattribute
- Updated:exportInstancesincludes new potential valueINTEGRATIONtoproductsattribute in theinstanceelement
- Updated:exportLevelsincludes newattributeIdandvalueIdtoattributeelement
- Updated:exportLevelsincludes newisLinkedandisEliminationattributes tolevelelement
- Updated:exportDimensionsincludes newattributeandattributeselements as descendants ofdimensionValueelement
- Updated:exportDimensionsincludes newlistDimension, keepSorted, anduseOnLevelsattributes todimensionelement
- Updated:exportSheetDefinitionincludes newrequiredattribute tolevels, text, dimension, text-selector, number, date, initial-balance, level-currency, display, timespanelements ofmodeled-sheet
- Updated:exportSheetDefinitionincludes newattributeelement for cube sheets
- Updated:exportSheetDefinitionincludes newsplit-column-titleandallow-splitsattributes tomodeled-sheetelement
- Updated: Import data APIs (importCubeData, importStandardData, importConfigurableModelData,importTransactions) now have context information as part of their error messages
- New: APIcreateDimension
- New: APIupdateDimension
- New: APIupdateDimensionValue
- New: APIcreateLevel
- New: APIupdateLevel