Playground

Playground

CostCenter

/api/v1/investments/cost-centers

A cost center for chargebacks.

listgetcreateupdate

Schema

FieldTypeNotes
id*uuidServer-assigned ULID with type prefix (e.g. per_…).
tenant_id*stringTenant scope — auto-stamped from the caller's JWT.
app_idstringApp scope. Stamped ONLY when the caller's JWT was minted for a specific Application (integration API keys). Absent for human-user sessions. Filters reads when present.
created_at*date-timeServer stamp.
updated_at*date-timeServer stamp; updated on every patch.
created_byuuidPerson id from the caller's JWT (sub).
updated_byuuidPerson id from the last writer's JWT (sub).
sourcestringProvenance tag — defaults to 'edm'.
source_typeenumfrontend | backend | server | system | apiWhere the write originated. Defaults to 'api'.
is_deletedbooleanSoft-delete flag. Excluded from default list queries.
deleted_atdate-timeStamped when soft-deleted; null otherwise.
deleted_byuuidPerson id who soft-deleted; null otherwise.
schema_versionnumberDocument schema version. Bumped on incompatible writes.
codestringUnique human-readable cost center code, as used in the financial system (e.g. 'CC-ENG-001').
namestringHuman-readable display name for this cost center.
owner_iduuidUUID of the Person who is the budget owner for this cost center.
parent_cost_center_iduuidUUID of the parent CostCenter, if this is a child node in a cost center hierarchy.
budget_amountnumberAnnual budget allocated to this cost center in the specified currency.
currencystringISO 4217 three-letter currency code for the budget amount.
fiscal_yearstringFiscal year to which the budgetAmount applies (e.g. '2026').
statusstringWhether this cost center is actively in use.

API

client.investments.costCenters.*
Loading manifest…