> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getruba.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Record Billable Activity
> Send immutable customer activity into the meter pipeline and understand which billing period receives it.
export const RubaSocials = () => {
if (typeof document === "undefined") {
return null;
}
const inject = () => {
const footer = document.getElementById("footer");
if (!footer || document.getElementById("ruba-socials")) {
return false;
}
const isDark = document.querySelector("html.dark") || document.querySelector('html[class*="dark"]');
const lineColor = isDark ? "#383838" : "#e8e8ed";
const iconColor = isDark ? "#8e8e93" : "#86868b";
const markColor = isDark ? "#ffffff" : "#08080c";
const hoverColor = "#0071e3";
const div = document.createElement("div");
div.id = "ruba-socials";
div.style.cssText = `display:flex;align-items:center;gap:20px;padding-top:20px;margin-top:20px;border-top:1px solid ${lineColor};width:100%`;
const logo = `Ruba`;
const spacer = ``;
const ig = ``;
const li = ``;
const x = ``;
const github = ``;
div.innerHTML = logo + spacer + ig + li + x + github;
footer.appendChild(div);
return true;
};
if (!document.documentElement.dataset.rubaSocialsObserver) {
document.documentElement.dataset.rubaSocialsObserver = "true";
const observer = new MutationObserver(() => {
if (!document.getElementById("ruba-socials")) {
inject();
}
});
observer.observe(document.body, {
childList: true,
subtree: true
});
}
setTimeout(() => {
if (!inject()) {
const interval = setInterval(() => {
if (inject()) {
clearInterval(interval);
}
}, 500);
setTimeout(() => clearInterval(interval), 10000);
}
}, 300);
return null;
};
An event is one timestamped record of something a buyer consumed inside your application. Your application sends these records to Ruba, and meters turn them into billable quantities. Common examples include tokens processed, video minutes streamed, or storage uploaded.
Send events through the [ingestion endpoint](/api-reference/events/ingest). Each record carries:
* `name`: the activity category, such as `ai_usage` or `file_uploaded`.
* `customer_id` or `external_customer_id`: the buyer responsible for the activity.
* `metadata`: numbers and labels that a meter can filter or aggregate.
For example, this record captures one model request and its token counts:
```json theme={"system"}
{
"name": "ai_usage",
"external_customer_id": "cus_123",
"metadata": {
"model": "gpt-4.1-nano",
"requests": 1,
"total_tokens": 77,
"request_tokens": 58,
"response_tokens": 19
}
}
```
## Send events with the Ruba SDK
Each event identifies its type, customer, and any metadata required by the meter.
```ts TypeScript theme={"system"}
import { Ruba } from "@getruba/sdk";
const ruba = new Ruba({ accessToken: process.env.RUBA_ACCESS_TOKEN ?? "" });
await ruba.POST("/v1/events/ingest", {
body: {
events: [{
name: "",
external_customer_id: "",
metadata: { key: "value" },
}],
},
});
```
Ingestion does not enforce a meter-credit balance. Your application decides whether a customer may continue an action after reading that balance.
## Operating rules
### Events cannot be edited
An accepted event is permanent: it cannot be updated or deleted. Use a new correcting event when your model requires an adjustment.
### Late timestamps do not reopen invoices
`timestamp` may point into the past for queue replay or batch delivery. Dashboards and the eventual invoice line date range use that supplied time, but billing-period assignment uses the time Ruba received the event.
An event received in the current cycle therefore stays in the current cycle even when its timestamp belongs to an older one. Ruba does not issue retroactive usage invoices or credits for late ingestion.