Update cost center

Updates a cost center. You can update the name, archive status, approver, delegate, delegate expiry, additional approvers (owner_ids), and cost object type (type) when that feature is enabled for your organization. Passing null for 'approver_id', 'delegate_id', 'delegate_expiry', 'owner_ids', or 'type' does not clear those fields; they remain unchanged. For owner_ids, pass an empty array to clear.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The unique ID of the cost center

Body Params
string

The new name for the cost center

string | null

Cost object type name to assign. Available only when cost object types are enabled for your organization on request. Non-empty string (max 256 characters). If a type with that name already exists (case-insensitive), it is assigned; otherwise it is created. Omit or null leaves the type unchanged (does not clear). If cost object types are not enabled, type is not a recognized field (a type-only body returns 400). Cannot be set on Yokoy-sourced cost centers (returns 400).

boolean

Set to 'true' to archive the cost center, or 'false' to unarchive it

integer

The ID of the user to set as approver. The user must belong to one of the cost center's companies. Passing 'null' does not clear the field

integer

The ID of the user to set as delegate. The delegate must belong to one of the cost center's companies. Passing 'null' does not clear the field

string

The expiry date for the delegate in YYYY-MM-DD format. Passing 'null' does not clear the field

string

Identifier used to associate this cost center with a corresponding record in an external ERP system

company_ids
array of integers

IDs of companies this cost center is scoped to. Must be provided together with 'all_companies'. At least one company required when 'all_companies' is false. Ignored when 'all_companies' is true (company scope is set to all companies in the account). Omit both fields to leave unchanged.

company_ids
boolean

Whether the cost center applies to all companies in the account. Must be provided together with 'company_ids'. When true, 'company_ids' is ignored and the cost center is scoped to all companies in the account. Omit both fields to leave unchanged.

owner_ids
array of integers

IDs of additional travel approvers. Omit or pass null to leave unchanged; pass an empty array to clear; pass a non-empty list to replace. Users must belong to an allowed company for the cost center and must not duplicate approver_id

owner_ids
Headers
string
required

Your Perk API key

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json