Agent Events API
Submit telemetry events via HTTP POST to track agent usage.Endpoint
Request Body
Send either a single event object or an array of events (max 100).Single Event
Batch Events
Event Fields
Response Formats
All Accepted (202)
Partially Accepted (207)
All Rejected (400)
Authentication Error (401)
Error Codes
Examples
cURL
Python
JavaScript
Rate Limits
- Batch size: Maximum 100 events per request
- Payload size: Maximum 1KB per event data field
- Frequency: No explicit rate limits, but use batching for high volumes
Authentication
Bearer tokens are optional. If provided:- Token must be valid and active
- User field auto-filled from token if missing
- Invalid tokens return 401 error
Best Practices
- Batch events when sending multiple events
- Include timestamps - use current epoch milliseconds
- Keep data small - under 1KB per event
- Use descriptive agent IDs - helps with analytics
- Handle errors gracefully - check response status
- Retry on network failures - implement exponential backoff