Logs

Send structured events from your server. Search them in the dashboard or through the API. Logs are included on every plan and count toward your storage quota. They are kept for the retention of your plan (see Plans and limits).

Send events

POST https://upload.basix.media/api/v1/logs, JSON.

curl -X POST https://upload.basix.media/api/v1/logs \
  -H "Authorization: Bearer $BASIX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "dataset": "economy",
    "events": [
      {
        "level": "warn",
        "message": "Suspicious money add",
        "player": "license:3f9a2b...",
        "resource": "esx_core",
        "metadata": { "amount": 999999, "source": "admin" }
      }
    ]
  }'

Response:

{ "accepted": 1, "used": { "bytes": "2097152" }, "quota": { "bytes": "10737418240" } }

Body: { "dataset": "...", "events": [ ... ] }, a bare array of events, or a single event. dataset can also be passed as ?dataset=. Default: default.

Limits: 500 events per request, 240 requests per minute per key. Batch your events. A full quota answers 413 QUOTA_EXCEEDED.

Search events

GET /api/v1/logs with any of: dataset (repeatable), level (repeatable), player, resource, search (text in the message), from, to (ISO dates), limit (1-200, default 50), cursor.

curl "https://upload.basix.media/api/v1/logs?dataset=economy&level=warn&level=error&player=license:3f9a2b...&limit=100" \
  -H "Authorization: Bearer $BASIX_KEY"

{
  "events": [
    {
      "id": "...",
      "dataset": "economy",
      "level": "warn",
      "message": "Suspicious money add",
      "resource": "esx_core",
      "player": "license:3f9a2b...",
      "metadata": { "amount": 999999 },
      "timestamp": "2026-10-25T14:00:00.000Z"
    }
  ],
  "nextCursor": null
}

Categories

A category gives a dataset a label, color, icon, order, group and columns read from metadata. Datasets without a category are listed with "auto": true.

Fields: label (1-60 chars), color (#rrggbb), icon (activity, home, files, key, card, user, book, shield, upload, database, link, play, lock, bolt, code, layers, check, sparkle), order (integer), group (up to 40 chars or null), columns (up to 30 of { key, label, type, visible }, type one of text, number, bool, date, player, link; key is a metadata path such as vehicle.plate). Up to 100 categories.

curl -X PATCH https://upload.basix.media/api/v1/logs/categories/economy \
  -H "Authorization: Bearer $BASIX_KEY" -H "Content-Type: application/json" \
  -d '{ "label": "Economy", "color": "#22c55e", "icon": "card", "group": "Gameplay",
        "columns": [ { "key": "amount", "label": "Amount", "type": "number", "visible": true } ] }'

Players

Every player value gets a profile: first and last seen, event counts per category, and identifiers found in metadata (license, license2, discord, steam, fivem, xbl, live, rockstar, citizenid).

PATCH accepts displayName, notes (up to 10,000 chars), identifiers and fields (objects, null removes a key, up to 50 each), or a single key + value. URL-encode the player in the path.

curl -X PATCH "https://upload.basix.media/api/v1/logs/players/license%3A3f9a2b" \
  -H "Authorization: Bearer $BASIX_KEY" -H "Content-Type: application/json" \
  -d '{ "displayName": "John", "identifiers": { "discord": "1234" }, "fields": { "job": "police" } }'

Saved views

Stored filters and columns, shown in the dashboard. Full key required.

Body: name (required on create), filters (categories, levels, player, resource, text, range one of 15m, 1h, 6h, 24h, 7d, 30d, or from/to), columns (metadata keys). shared defaults to true (visible to the whole team). false makes the view personal to the key's creator.

Alerts

A rule fires when threshold matching events arrive within windowMinutes. It then stays quiet for cooldownMinutes. It posts to a Discord webhook, to your webhook endpoints (event log.alert), or both. Rules are checked after each ingest. Full key required.

curl -X POST https://upload.basix.media/api/v1/logs/alerts \
  -H "Authorization: Bearer $BASIX_KEY" -H "Content-Type: application/json" \
  -d '{
    "name": "Money exploit",
    "conditions": { "categories": ["economy"], "levels": ["warn", "error"], "contains": "money",
                    "metadata": [ { "key": "source", "equals": "admin" } ] },
    "threshold": 3, "windowMinutes": 5, "cooldownMinutes": 15,
    "discordWebhookUrl": "https://discord.com/api/webhooks/123456789/your-webhook-token"
  }'

The number of rules depends on your plan. Over the limit, creating one answers 403 PLAN_REQUIRED.

Get alerted on Discord

Create an alert rule with discordWebhookUrl (see Alerts). Example: 3 warn or error events in the economy dataset within 5 minutes.