Documentation
API reference, SDK usage, and integration guides for the CodingVibez Data Ingest API
Overview
The Data Ingest API lets you push cost and token usage from your apps, scripts, or AI agents into your CodingVibez dashboard. Track expenses (hosting, APIs, subscriptions) and AI token consumption (OpenAI, Anthropic, etc.) in one place.
API
Single endpoint: POST /api/ingest. Send JSON with type (cost or tokens), service, and data.
Authentication
API keys (Bearer). Sign in to generate keys. Keys are org-scoped and encrypted in Vault.
Quick start
- Create an API key by signing in and going to API Docs → Authentication.
- Store it in your app (e.g.
CODINGVIBEZ_API_KEYorINGEST_API_KEY). - Send a request:
curl -X POST https://codingvibez.com/api/ingest \
-H "Authorization: Bearer $CODINGVIBEZ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"cost","service":"OpenAI","data":{"amount":125.5,"month":1,"year":2026}}'API summary
| Endpoint | Purpose |
|---|---|
POST /api/ingest | Send cost or token usage |
GET /api/ingest | API metadata (no auth) |
POST /api/ingest/generate-key | Create API key (requires logged-in user) |
Cost: data.{ amount, month, year } required. Tokens: data.{ month, year, tokens_used } required; cost, input_tokens, output_tokens optional.
SDK and examples
There is no official npm or pip package. Use the HTTP API with fetch, axios, or requests. For ready-to-use snippets in cURL, JavaScript, TypeScript, Python, and Go, and to manage keys:
For AI coding agents
A structured integration guide is available so you can point an AI coding agent at it to add cost tracking to any project.