Skip to main content
Creates a custom pricing row. This endpoint requires an Admin API key and records an audit log entry.

​
Request

{
  "provider": null,
  "model": null,
  "metric": "search_requests",
  "price_per_unit_usd": 0.01,
  "effective_from": "2026-06-11T00:00:00.000Z",
  "source": "builder_manual",
  "notes": "Search API list price."
}
For LLM pricing, send provider and model and leave metric null: 
{
  "provider": "openai",
  "model": "gpt-4o-mini",
  "metric": null,
  "price_per_unit_usd": 0,
  "input_per_1m_usd": 0.15,
  "output_per_1m_usd": 0.6,
  "effective_from": "2026-06-11T00:00:00.000Z",
  "source": "builder_manual"
}

​
Response

{
  "id": "00000000-0000-0000-0000-000000000000"
}

​
Notes

  • Set either (provider + model) or metric, not both.
  • Duplicate effective pricing rows return a validation error.
  • Pricing changes can affect margin reports and billing workflows.