Send tracking calls
POST/v1/batch
Segment/RudderStack calls (page, track, identify, alias, group, screen), as a batch or one call, with any write key. Any Segment or RudderStack SDK can send here with this host as its data-plane URL; a RudderStack webhook destination can post single calls here with a server key. The edge fills a missing messageId and timestamp, the type from the route, and the browser's user agent; it removes the IP. Every call is kept as it arrived; what it becomes is decided after the acknowledgement. The request is accepted or refused as a whole: refusals concern the key, the owner, the limits or a call that is not a call.
Request
Responses
- 202
- 400
- 401
- 403
- 413
- 429
- 503
Every call is durably stored.
Response Headers
Malformed request, a call without a known type, or a call that names no valid owner. Nothing was stored.
Missing, unknown or revoked write key, or a secret key in the body.
The key is not allowed from this Origin.
Request body over 500 KB.
Rate limit of the key exceeded. Retry after the number of seconds in Retry-After.
Response Headers
The log could not take the calls. Nothing was stored; retry.