Events API

Use the Events API for push stream ingestion. Push stream ingestion loads your data from a source data stream to a destination table in Imply Polaris. See Push event data by API for more details and examples.

All URIs are relative to https://api.imply.io/v1

Push events to a table

Send a POST request to the Events API and pass the event data in the payload. Each request payload is limited to 1 MB in size. Each Polaris organization is limited to 83,334 calls per minute. We recommend that you include up to 60 events in a batch per request. This effectively limits your rate to approximately 5 million events per minute.

See Event payload requirements for limitations of the request payload.

URL

POST /events/{tableId}

Parameters

Path parameters

  • tableId   type: String   required
    The ID of the table for which to push data.

Request body

  • type: raw JSON object
    Data to be pushed to the table in Polaris in newline-delimited JSON format. The JSON body must include the event time as a key-value pair, where the __time key is mapped to the timestamp in ISO format.

Responses


OK.


Not Found.


Too Many Requests.

Example body:

{
    "message": "API rate limit exceeded"
}

See View rate limits for how to view request rate limits and time until the limit resets.

Sample request

curl --location --request POST 'https://api.imply.io/v1/events/149d245a-1207-4946-9057-88c56354482c' \
--header 'Authorization: Bearer <Bearer Token>' \
--header 'Content-Type: application/json' \
--data-raw '{"__time":"2015-09-12T00:46:58.771Z","channel":"#en.wikipedia","added":36,"deleted":0}'
← Reference indexFiles API →