Dimensions

Authentication

Authenticate with Authorization: Bearer ak_... — see API keys. Requests are scoped to one entity. Pass entityId as a query parameter, JSON field, or x-entity-id header. API keys are already pinned to an entity. A mismatched entityId returns 403.

Endpoints

List dimensions

GET /api/ledger/dimensions?entityId={entityId}

Returns an array of dimensions (e.g., department, project, location).

[
  {
    "id": "dim_abc123",
    "name": "Department",
    "values": ["Sales", "Engineering", "Operations"]
  }
]

Create dimension

POST /api/ledger/dimensions

Body: { "entityId", "name", "values" }

Update / Delete

PUT /api/ledger/dimensions — body: { "entityId", "dimensionId", "name?", "values?" }

DELETE /api/ledger/dimensions — body: { "entityId", "dimensionId" }