Create Events Batch Import
Creates a batch events import job with the given list of event information.
This is the first step in an asynchronous workflow. This request can be made idempotent.
Payload Limits
The number of request objects that can be included in a single batch request is 50,000
.
Header Parameters
Optional header for marking the request to be idempotent
Request Body required
The request payloads contains the list of events to be imported
- Array [
- ]
requests object[] required
The list of event requests that should be imported
user object optional
The user identifier.
If session.id
is provided, the session.id
is enough to identify a session for which to create the event, and user
will not be accepted.
If session.use_most_recent
is set to true
, one and only oneuser
field is required.
Possible values: <= 256 characters
The application-specific ID you've given to the user.
The Fullstory-assigned user ID. This value is returned in a POST /v2/users
(create user) response.
session object optional
The session identifier.
The Fullstory generated identifier for the session to associate the event with.
Associate events with the most recent session captured from the user.
If set to true
, a user
is required. The user must have a session within the past 30 minutes, otherwise the events will be created for the user without a session.
It is recommended to use session.id
instead, when creating events for a specific session.
context object optional
The context in which the events are attached to.
browser object optional
The browser context in which the events are attached to.
mobile object optional
The mobile context in which the events are attached to.
device object optional
The device context in which the events are attached to.
location object optional
The location context in which the events are attached to.
ISO 3166-1 alpha-2 standard country code.
ISO-3166-2 standard region code.
Name of the city.
The event's name.
Optional. The event's timestamp represented in ISO 8601 format. If not provided, the current Fullstory server time will be used. It is recommended to always set the timestamp.
Optional. The custom event's payload.
schema object optional
Optional. Schema declaration, to define the structure of the data, the schema will override Fullstory's default type inference.
A mapping of field names to their corresponding types.
shared object optional
If there is any shared
data from the original import request that may have caused conflict with data from within this event.
context object optional
The context in which the events are attached to.
browser object optional
The browser context in which the events are attached to.
mobile object optional
The mobile context in which the events are attached to.
device object optional
The device context in which the events are attached to.
location object optional
The location context in which the events are attached to.
ISO 3166-1 alpha-2 standard country code.
ISO-3166-2 standard region code.
Name of the city.
A successful response.
Schema
job object required
Information about the job that was initiated to import the list of events submitted.
ID of the job.
Possible values: [PROCESSING
, COMPLETED
, FAILED
]
Status of the job.
Time the job was accepted.
Time the job was finished, either successfully or unsuccessfully.
{
"job": {
"id": "abc123",
"status": "PROCESSING",
"created": "2017-01-15T01:30:15.01Z"
}
}
Returned when invalid input has been provided. Fix the issue and retry.
Schema
Long form description of what went wrong
A short snake-cased value that is safe to handle programmatically
{
"message": "uid is required",
"code": "required_field"
}
Returned when access to the resource is unauthorized.
Schema
Long form description of what went wrong
A short snake-cased value that is safe to handle programmatically
{
"message": "access is unauthorized",
"code": "unauthorized"
}
Returned when access is not allowed due to insufficient permissions.
Schema
Long form description of what went wrong
A short snake-cased value that is safe to handle programmatically
{
"message": "insufficient permissions",
"code": "forbidden"
}
Returned when the resource does not exist.
Schema
Long form description of what went wrong
A short snake-cased value that is safe to handle programmatically
{
"message": "Requested resource does not exist",
"code": "resource_not_found"
}
Returned when the client has exceeded the rate limit for this endpoint. A Retry-After
header will be included with the response. This header will contain the number of seconds that you should wait before attempting to send another request.
Schema
Long form description of what went wrong
A short snake-cased value that is safe to handle programmatically
{
"message": "Too many requests. Client has exceeded the rate limit for this endpoint.",
"code": "too_many_requests"
}
Returned when a server error is encountered.
Schema
Long form description of what went wrong
A short snake-cased value that is safe to handle programmatically
{
"message": "Server error was encountered",
"code": "server_error"
}