diff --git a/src/connections/sources/catalog/libraries/server/http-api/index.md b/src/connections/sources/catalog/libraries/server/http-api/index.md index fa6cca8ceb..00b7c4d6f6 100644 --- a/src/connections/sources/catalog/libraries/server/http-api/index.md +++ b/src/connections/sources/catalog/libraries/server/http-api/index.md @@ -462,7 +462,8 @@ When sending a HTTP call from a user's device, you can collect the IP address by Segment returns a `200` response for all API requests except errors caused by large payloads and JSON errors (which return `400` responses.) To debug events that return `200` responses but aren't accepted by Segment, use the Segment Debugger. Common reasons events are not accepted by Segment include: - - **Payload is too large:** The HTTP API can handle API requests that are 32KB or smaller. The batch API endpoint accepts a maximum of 500KB per request, with a limit of 32KB per event in the batch. If these limits are exceeded, Segment returns a 400 Bad Request error. + - **Payload is too large:** The HTTP API can handle API requests that are 32KB or smaller. If these limits are exceeded, Segment returns a 400 Bad Request error. + - **The `\batch` API endpoint** This endpoint accepts a maximum of 500KB per 1 batched request, up to 2500 batched events in the request, and 32KB per each event. Segment will return a `200` response but reject the event, when the number of batched events exceed limit. - **Identifier is not present**: The HTTP API requires that each payload has a userId and/or anonymousId. If you send events without either the userId or anonymousId, Segment’s tracking API responds with an no_user_anon_id error. Check the event payload and client instrumentation for more details. - **Track event is missing name**: All Track events sent to Segment must have an `event` field. - **Deduplication**: Segment deduplicates events using the `messageId` field, which is automatically added to all payloads coming into Segment. If you're setting up the HTTP API yourself, ensure all events have unique messageId values with fewer than 100 characters.