Events

1Request

Key in X-Blipit-Key (public or secret) or ?key=. Odoo also sends X-Blipit-Instance. Body up to 256 KB, nested at most 32 levels. Required: event_id (32 lowercase hex), timestamp (ISO 8601), platform, sdk {name, version}, and a message or an exception. Optional: level, release, environment, user {id, email, username}, tags, breadcrumbs, request {method, url, headers}, contexts, fingerprint (array of strings that replaces the computed grouping), security (secret key only).

curl https://in.blipit.io/api/v1/events \
  -H "Content-Type: application/json" -H "X-Blipit-Key: <public key>" \
  -d '{
    "event_id": "0123456789abcdef0123456789abcdef",
    "timestamp": "2026-09-28T09:15:00Z",
    "platform": "python",
    "level": "error",
    "release": "shop@1.4.2",
    "environment": "production",
    "exception": {
      "type": "KeyError",
      "value": "customer_id",
      "stacktrace": { "frames": [{ "filename": "shop/cart.py", "function": "checkout", "lineno": 42, "in_app": true }] }
    },
    "tags": { "company_id": "1" },
    "sdk": { "name": "my-sdk", "version": "1.0.0" }
  }'

2Responses

202 {id} accepted. 202 {accepted: false, sampled: true, plan} over the monthly cap: the event was counted, not stored. 400 schema error with detail, or nesting too deep. 401 unknown key. 403 key bound to another instance, security event with a public key (security_needs_secret_key), or security monitoring not in the plan. 429 rate limited.

3Sentry SDKs

POST /api/<project id>/envelope/ and the older /api/<project id>/store/, key in X-Sentry-Auth or ?sentry_key=, body gzip, deflate or brotli up to 1 MB (4 MB inflated). The key must belong to the project in the URL. Up to 10 event items per envelope; transaction and span items become spans; session, sessions, user_report and feedback items feed release health and feedback; replays and profiles are dropped.

Good to know

• 300 requests a minute per key, shared with spans and logs.
• Sending the same event_id twice stores it once.
• The public key cannot set tags.db; it is dropped so the Odoo copy-detection baseline cannot be poisoned.