FAfactorialhr
Finance > CostCenter

Edits a Cost center

Changed on

Edits a Cost center

post/api/2026-10-01/resources/finance/cost_centers/edit

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/finance/cost_centers/edit
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: finance
    • or API key in header x-api-key

Request body

idstring required

Id of the cost center to edit.

namestring

New name of the cost center.

codestring

New code of the cost center.

descriptionstring

New description of the cost center.

company_idstring

Deprecated and unused; the company is derived from the authenticated credentials.

Example request

{
  "id": "1",
  "name": "Marketing",
  "code": "CC-001",
  "description": "Cost center for the marketing department"
}

Response

OK

idstring required

Factorial id of the cost center.

namestring required

Name of the cost center.

company_idstring required

Company id the cost center belongs to.

legal_entity_idstring

Legal entity id the cost center belongs to.

codestring

Optional unique code of the cost center.

descriptionstring

Optional free text describing the cost center.

active_employees_countinteger required

Number of employees currently assigned to the cost center.

historical_employees_countinteger required

Number of employees ever assigned to the cost center.

statusstring required

Whether the cost center is active or inactive.

deactivation_datestring

Date the cost center was deactivated, if inactive.

Example response

{
  "id": "1",
  "name": "Marketing",
  "company_id": "1",
  "legal_entity_id": "125",
  "code": "CC-001",
  "description": "Cost center for the marketing department",
  "status": "active"
}

Changes