Ingest a batch of events
POST/v1/events
Stores 1 to 500 canonical events. A problem with one event rejects that event only; the response lists every problem of each rejected row, one errors entry per problem. The batch is complete when the response is sent. Deduplication is per event, by event_id or the content hash, so a retried batch reports its stored rows as duplicates. This operation ignores Idempotency-Key. API keys only: a session is refused with 401.
Request
Responses
- 200
- 400
- 401
- 403
- 413
- 414
- 415
- 429
- 500
The batch was processed. Rows that failed are in errors.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
Sent on every response to an API key once the rate limiter has run: absent on 401 and 403, and on every response to a session. The quota left in the one policy the request consumed, as IETF draft-ietf-httpapi-ratelimit-headers-11 specifies, e.g. "api";r=599;t=1. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change. Do not base retries on it; retry on Retry-After.
Sent whenever RateLimit is. Every policy the key is subject to, as IETF draft-11 specifies. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change.
invalid_json: the body is not one JSON object. validation_failed: a field, parameter, header or multipart part breaks a rule; errors lists every problem.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
Sent on every response to an API key once the rate limiter has run: absent on 401 and 403, and on every response to a session. The quota left in the one policy the request consumed, as IETF draft-ietf-httpapi-ratelimit-headers-11 specifies, e.g. "api";r=599;t=1. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change. Do not base retries on it; retry on Retry-After.
Sent whenever RateLimit is. Every policy the key is subject to, as IETF draft-11 specifies. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change.
No credential, or the credential failed.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
RFC 9110 §11.6.1 and RFC 6750 §3. Bearer alone when no credential, or a credential under another scheme, was sent. Bearer error="invalid_token" when the credential failed. A 403 insufficient_scope carries its own challenge, declared on the Forbidden responses.
The API key lacks the ingest scope.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
Bearer error="insufficient_scope", scope="ingest" (RFC 6750 §3.1).
The body is over the operation's limit: its x-body-limit, or the 1M default when it declares none.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
Sent on every response to an API key once the rate limiter has run: absent on 401 and 403, and on every response to a session. The quota left in the one policy the request consumed, as IETF draft-ietf-httpapi-ratelimit-headers-11 specifies, e.g. "api";r=599;t=1. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change. Do not base retries on it; retry on Retry-After.
Sent whenever RateLimit is. Every policy the key is subject to, as IETF draft-11 specifies. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change.
The query string holds more than 10,000 parameters. Every &-separated pair counts, empty ones included. No parameter is at fault on its own, so the response carries no errors.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
Sent on every response to an API key once the rate limiter has run: absent on 401 and 403, and on every response to a session. The quota left in the one policy the request consumed, as IETF draft-ietf-httpapi-ratelimit-headers-11 specifies, e.g. "api";r=599;t=1. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change. Do not base retries on it; retry on Retry-After.
Sent whenever RateLimit is. Every policy the key is subject to, as IETF draft-11 specifies. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change.
The Content-Type is not one this operation takes, or names a charset other than utf-8 on a JSON media type.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
Sent on every response to an API key once the rate limiter has run: absent on 401 and 403, and on every response to a session. The quota left in the one policy the request consumed, as IETF draft-ietf-httpapi-ratelimit-headers-11 specifies, e.g. "api";r=599;t=1. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change. Do not base retries on it; retry on Retry-After.
Sent whenever RateLimit is. Every policy the key is subject to, as IETF draft-11 specifies. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change.
The API key is over its rate limit.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
Seconds to wait before retrying (RFC 9110 §10.2.3). Takes precedence over the RateLimit fields.
Sent on every response to an API key once the rate limiter has run: absent on 401 and 403, and on every response to a session. The quota left in the one policy the request consumed, as IETF draft-ietf-httpapi-ratelimit-headers-11 specifies. On a 429 it is r=0, and t equals Retry-After, e.g. "api";r=0;t=1. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change. Do not base retries on it; retry on Retry-After.
Sent whenever RateLimit is. Every policy the key is subject to, as IETF draft-11 specifies. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change.
An unexpected error. Nothing was stored.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
Sent on every response to an API key once the rate limiter has run: absent on 401 and 403, and on every response to a session. The quota left in the one policy the request consumed, as IETF draft-ietf-httpapi-ratelimit-headers-11 specifies, e.g. "api";r=599;t=1. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change. Do not base retries on it; retry on Retry-After.
Sent whenever RateLimit is. Every policy the key is subject to, as IETF draft-11 specifies. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change.