Ingests one CostSample over HTTP (the Anthropic cost_report or a live runtime-cost sample) through the SAME canonical onCost path the bus uses — so it shares the natural-key dedup, the attribution resolution and the single-provenance CostRecord ledger; it never opens a second divergent path.

POST

/v1/m/finops/cost

curl --request POST \
  --url https://example.com/v1/m/finops/cost \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "actor": "example", "api_key_ref": "example", "cache_creation_1h_tokens": 1, "cache_creation_5m_tokens": 1, "cache_read_tokens": 1, "context_window": "example", "cost_micro_usd": 1, "cost_type": "example", "gateway": "example", "inference_geo": "example", "input_tokens": 1, "labels": { "additionalProperty": "example" }, "model_ref": "example", "occurred_at": "2026-04-15T12:00:00Z", "output_tokens": 1, "provenance": "example", "provider_ref": "example", "service_tier": "example", "session_ref": "example", "workspace_ref": "example" }'

• this engine

Ingests one CostSample over HTTP (the Anthropic cost_report or a live runtime-cost sample) through the SAME canonical onCost path the bus uses — so it shares the natural-key dedup, the attribution resolution and the single-provenance CostRecord ledger; it never opens a second divergent path.

Authorizations

• bearerAuth

Parameters

Header Parameters

X-Olivares-Tenant

string format: uuid

Target tenant id; required when the principal can act in more than one tenant.

Request Body ^required

Media type application/json

Any of:

object

object

actor

string

api_key_ref

string

cache_creation_1h_tokens

integer format: int64

cache_creation_5m_tokens

integer format: int64

cache_read_tokens

integer format: int64

context_window

string

cost_micro_usd

integer format: int64

cost_type

string

gateway

string

inference_geo

string

input_tokens

integer format: int64

labels

object

key

additional properties

string

model_ref

string

occurred_at

string format: date-time

output_tokens

integer format: int64

provenance

string

provider_ref

required

>= 1 characters

service_tier

string

session_ref

string

workspace_ref

string

object

object

actor

string

api_key_ref

string

cache_creation_1h_tokens

integer format: int64

cache_creation_5m_tokens

integer format: int64

cache_read_tokens

integer format: int64

context_window

string

cost_micro_usd

integer format: int64

cost_type

string

gateway

string

inference_geo

string

input_tokens

integer format: int64

labels

object

key

additional properties

string

model_ref

required

>= 1 characters

occurred_at

string format: date-time

output_tokens

integer format: int64

provenance

string

provider_ref

string

service_tier

string

session_ref

string

workspace_ref

string

Example ^generated

{
  "actor": "example",
  "api_key_ref": "example",
  "cache_creation_1h_tokens": 1,
  "cache_creation_5m_tokens": 1,
  "cache_read_tokens": 1,
  "context_window": "example",
  "cost_micro_usd": 1,
  "cost_type": "example",
  "gateway": "example",
  "inference_geo": "example",
  "input_tokens": 1,
  "labels": {
    "additionalProperty": "example"
  },
  "model_ref": "example",
  "occurred_at": "2026-04-15T12:00:00Z",
  "output_tokens": 1,
  "provenance": "example",
  "provider_ref": "example",
  "service_tier": "example",
  "session_ref": "example",
  "workspace_ref": "example"
}

Responses

200

OK

Media type application/json

object

Example ^generated

{}

400

Bad request

Media type application/json

object

Example ^generated

{}

401

Unauthenticated

Media type application/json

object

Example ^generated

{}

403

Forbidden

Media type application/json

object

Example ^generated

{}

404

Not found

Media type application/json

object

Example ^generated

{}

409

Conflict / setup required

Media type application/json

object

Example ^generated

{}

429

Rate limited

Media type application/json

object

Example ^generated

{}