Ingest Evaluation Events

curl -X POST https://nest.feather.mupeni.dev/v1/telemetry/events \
  -H "Authorization: Bearer <server_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      {
        "flagKey": "new-checkout",
        "flagId": "flag_01hx...",
        "environmentId": "env_01hx...",
        "orgId": "org_01hx...",
        "value": true,
        "reason": "RULE_MATCH",
        "ruleId": "rule-beta",
        "sdkType": "server",
        "sdkVersion": "1.0.0",
        "evaluatedAt": "2024-04-11T10:00:00.000Z"
      }
    ]
  }'

POST

telemetry

events

curl -X POST https://nest.feather.mupeni.dev/v1/telemetry/events \
  -H "Authorization: Bearer <server_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      {
        "flagKey": "new-checkout",
        "flagId": "flag_01hx...",
        "environmentId": "env_01hx...",
        "orgId": "org_01hx...",
        "value": true,
        "reason": "RULE_MATCH",
        "ruleId": "rule-beta",
        "sdkType": "server",
        "sdkVersion": "1.0.0",
        "evaluatedAt": "2024-04-11T10:00:00.000Z"
      }
    ]
  }'

This endpoint is called by the SDK automatically — you do not need to call it directly. Events are processed asynchronously in under 50ms. The response does not wait for aggregation to complete. Auth: API key only.

Body

events

EvalEvent[]

required

1–100 events per batch.

Each EvalEvent:

Field	Type	Required	Description
`flagKey`	string	✓
`flagId`	string	✓
`environmentId`	string	✓
`orgId`	string	✓	Must match the authenticated org
`value`	`boolean \| string \| number`	✓	The resolved value
`reason`	string	✓	One of: `DISABLED`, `CLIENT_RESTRICTED`, `RULE_MATCH`, `ROLLOUT`, `DEFAULT`, `FLAG_NOT_FOUND`, `ERROR`
`ruleId`	string		Present when `reason` is `RULE_MATCH` or `ROLLOUT`
`userIdHash`	string		SHA-256 of the user ID
`anonymousIdHash`	string		SHA-256 of the anonymous ID
`sdkType`	`"server" \| "client" \| "edge"`	✓
`sdkVersion`	string	✓
`evaluatedAt`	string	✓	ISO 8601

Events attributed to a different orgId than the authenticated key are silently dropped. Always use the orgId returned by Get SDK Context.

curl -X POST https://nest.feather.mupeni.dev/v1/telemetry/events \
  -H "Authorization: Bearer <server_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      {
        "flagKey": "new-checkout",
        "flagId": "flag_01hx...",
        "environmentId": "env_01hx...",
        "orgId": "org_01hx...",
        "value": true,
        "reason": "RULE_MATCH",
        "ruleId": "rule-beta",
        "sdkType": "server",
        "sdkVersion": "1.0.0",
        "evaluatedAt": "2024-04-11T10:00:00.000Z"
      }
    ]
  }'

http 202

Get SDK Context Backfill Analytics

​Body

Body