Update existing business unit configuration

1 min

PUT

https://app.amberflo.io/business-unit/details

Updates configuration and metadata for an existing business unit in your organization. Modifies business unit properties including display name, description, and contact information for cost allocation.

Required request body fields:

id: Identifier for the business unit to update (must exist in organization)
name: Updated display name for management interfaces and reports

Optional fields:

description: Updated description of business unit purpose and organizational scope
contacts: Updated contact information for business unit owners and managers

Returns updated business unit with modified timestamp and complete configuration. Business unit ID cannot be changed after creation and must match existing registry entry.

Body Parameters

bodybusiness_unit.details.BusinessUnit.in
Description
Input configuration for business unit registration and management. Defines organizational entities for cloud cost allocation, budget control, and departmental spending tracking within FOCUS-compliant cost management systems.
- idstringrequired
  Description
  Unique business unit identifier for cost allocation and organizational tracking. Used in FOCUS data ingestion and chargeback calculations across cloud resources.
- namestringrequired
  Description
  Human-readable business unit display name shown in management interfaces and cost reports. Required for user identification and organizational hierarchy navigation.
- descriptionstring
  Description
  Optional detailed description explaining business unit purpose, scope, and organizational context for cost allocation and budget management activities.
- contactsbusiness_unit.details.BusinessUnitContact.in[]
  Description
  Contact information array for business unit owners and managers responsible for cost oversight and budget approvals.
  - emailstringrequired
    Description
    Business unit contact email address for cost notifications and budget alerts. Used for automated reporting and budget threshold communications.
  - namestringrequired
    Description
    Full name of business unit contact person responsible for cost oversight and budget management decisions within the organizational structure.

Responses

200Successful request

business_unit.details.BusinessUnit.out
Description
Complete business unit configuration with system audit timestamps. Represents organizational entities for cloud cost allocation, budget control, and departmental spending tracking within FOCUS-compliant cost management systems.
- idstringrequired
  Description
  Unique business unit identifier for cost allocation and organizational tracking. Used in FOCUS data ingestion and chargeback calculations across cloud resources.
- namestringrequired
  Description
  Human-readable business unit display name shown in management interfaces and cost reports. Required for user identification and organizational hierarchy navigation.
- descriptionstring
  Description
  Optional detailed description explaining business unit purpose, scope, and organizational context for cost allocation and budget management activities.
- contactsbusiness_unit.details.BusinessUnitContact.out[]
  Description
  Contact information array for business unit owners and managers responsible for cost oversight and budget approvals.
  - emailstringrequired
    Description
    Business unit contact email address for cost notifications and budget alerts. Used for automated reporting and budget threshold communications.
  - namestringrequired
    Description
    Full name of business unit contact person responsible for cost oversight and budget management decisions within the organizational structure.
- createTimeInMillisinteger<int64>
  Description
  Business unit creation timestamp in Unix milliseconds. System-generated when business unit configuration is first registered in cost management system.
- updateTimeInMillisinteger<int64>
  Description
  Last modification timestamp in Unix milliseconds. Updated automatically whenever business unit configuration details are changed through management interfaces.

curl

curl --request PUT \
     --url https://app.amberflo.io/business-unit/details \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "id": "",
     "name": "",
     "contacts": [
     {
     "email": "",
     "name": ""
     }
     ]
     }'

javascript

var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");

var raw = JSON.stringify({
   "id": "",
   "name": "",
   "contacts": [
      {
         "email": "",
         "name": ""
      }
   ]
});

var requestOptions = {
   method: 'PUT',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("https://app.amberflo.io/business-unit/details", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

ruby

require "uri"
require "json"
require "net/http"

url = URI("https://app.amberflo.io/business-unit/details")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Put.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request.body = JSON.dump({
   "id": "",
   "name": "",
   "contacts": [
      {
         "email": "",
         "name": ""
      }
   ]
})

response = https.request(request)
puts response.read_body

python

import requests
import json

url = "https://app.amberflo.io/business-unit/details"

payload = json.dumps({
   "id": "",
   "name": "",
   "contacts": [
      {
         "email": "",
         "name": ""
      }
   ]
})
headers = {
   'accept': 'application/json',
   'content-type': 'application/json'
}

response = requests.request("PUT", url, headers=headers, data=payload)

print(response.text)

200

// Successful request
{
  "id": "",
  "name": "",
  "description": "",
  "contacts": [
    {
      "email": "",
      "name": ""
    }
  ],
  "createTimeInMillis": "",
  "updateTimeInMillis": ""
}