Skip to main content
POST
/
beacon
curl -X POST "https://kodostatus.com/api/beacon" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "bpk_your_key_here",
    "events": [{
      "type": "error",
      "timestamp": 1704844800000,
      "session_id": "sess_abc123",
      "url": "https://example.com/dashboard",
      "service": "my-app",
      "environment": "production",
      "data": {
        "message": "Cannot read property x of undefined",
        "stack": "TypeError: Cannot read property...",
        "type": "TypeError"
      }
    }],
    "user": { "id": "user123", "email": "[email protected]" }
  }'

{
  "success": true,
  "received": 1,
  "signatures_updated": 1,
  "logs_stored": 0,
  "traces_stored": 0,
  "spans_stored": 0
}
This endpoint does not require API key authentication. Use your beacon public key (bpk_...) in the request body.

​
Body Parameters

​
key
string
required
Your beacon public key (bpk_...) or API key
​
events
array
required
Array of events to report

​
Event Object

​
events[].type
string
required
Event type: error, log, trace, vital, page_load, slow_request
​
events[].timestamp
number
required
Unix timestamp in milliseconds
​
events[].session_id
string
required
Unique session identifier
​
events[].url
string
Page URL where event occurred
​
events[].service
string
Service/app name
​
events[].environment
string
Environment: production, staging, development
​
events[].data
object
Event-specific data (error message, stack trace, etc.)
​
user
object
User context: { id, email, username }

​
Response

​
success
boolean
Whether events were recorded
​
received
integer
Number of events received
curl -X POST "https://kodostatus.com/api/beacon" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "bpk_your_key_here",
    "events": [{
      "type": "error",
      "timestamp": 1704844800000,
      "session_id": "sess_abc123",
      "url": "https://example.com/dashboard",
      "service": "my-app",
      "environment": "production",
      "data": {
        "message": "Cannot read property x of undefined",
        "stack": "TypeError: Cannot read property...",
        "type": "TypeError"
      }
    }],
    "user": { "id": "user123", "email": "[email protected]" }
  }'

{
  "success": true,
  "received": 1,
  "signatures_updated": 1,
  "logs_stored": 0,
  "traces_stored": 0,
  "spans_stored": 0
}