Budget Endpoints

Budget Object

  • id (string, uuid) - Id of the budget
  • plan_id (string, uuid) - The Id of the plan the budget belongs to
  • cost_owner_id (string, uuid) - The Id of the Cost Owner the budget belongs to
  • created_time (integer) - The time the budget was initially created
  • modified_time (integer) - The time the budget was last modified
  • p0 (decimal) - Value for the first fiscal period
  • p77 (decimal) - Value for the last fiscal period
  • q0 (decimal) - Value for the first quarter
  • q23 (decimal) - Value for the last quarter
  • fy0 (decimal) - Value for the first year
  • fy5 (decimal) - Value for the last year

Sample Example

{
  "id": "65a4839b-35ef-438d-8958-b68d2423fcc1",
  "is_editable": true,
  "cost_owner": {
                 "name": "A Cost Owner",
                 "id": "1cf4ae4c-4c33-4427-9b97-030b42ab4eed"
				},
  "budgets_as_flat_amounts": {
                 "p0": 21666.666666666667,
                 "q1": 65000.000000000001,
                 "p1": 21666.666666666667,
                 "q2": 65000.000000000001,
                 "p2": 21666.666666666667,
                 "q3": 65000.000000000001,
                 "p3": 21666.666666666667,
                 "p4": 21666.666666666667,
                 "p5": 21666.666666666667,
                 "p6": 21666.666666666667,
                 "p7": 21666.666666666667,
                 "p8": 21666.666666666667,
                 "p9": 21666.666666666667,
                 "p10": 21666.666666666667,
                 "p11": 21666.666666666667,
                 "fy0": 260000.000000000004,
                 "q0": 65000.000000000001

Import

curl -X POST ' https://api.cloudability.com/v3/planning/imports' \
	 -H 'Apptio-Current-Environment: [apptio Frontdoor environment id]' \
	 -H 'Apptio-Opentoken: [apptio opentoken]' \
	 -F 'file=@/path/to/file/file.csv' \
	 -F 'encoding=UTF_8' \
	 -F 'delimiter=COMMA' \
	 -F 'planId=e904b327-6009-4f02-95c3-8483b45a6cfb' \
	 -F 'type=MERGE' \
	 -F 'viewId=0' \
	 -F 'target=BUDGET_TARGET'
  • Go to the User Interface and export budgets to get a file that is in the correct format to be used for importing.
  • Use the Get Import Job By Id or Get Imports endpoints to check the status of the import job.