FEfeverup
Sessions

Request sessions

Create a request to get sessions that belong to plans that are set as ready.The field session_ids can be used to filter the sessions in the report by id.The field plan_ids can be used to include only sessions from certain plans in the report.The union of the two sets will be used to filter the sessions.That is, if a session is in session_ids but its plan is not in plan_ids, it will be included, and viceversa.Optionally, the fields updated_date_utc_from and updated_date_utc_to can be used to restrict results to sessions whose warehouse row was last updated within the given half-open UTC window (>= from, < to). Both bounds must be sent together; sending only one returns 422.The search will be processed asynchronously, being able to fetch the result from the provided search ID.

post/sessions/search

Request

Headers

user-id-to-impersonateinteger

User id from the user that you want to impersonate

Request body

session_idsinteger[]

List of ids of the sessions to filter by.

plan_idsinteger[]

List of ids of the plans to filter by.

updated_date_utc_fromstring

UTC start date for the warehouse last-updated filter (inclusive). Filters rows whose underlying warehouse record changed at or after this instant. If hour and minute are not specified, 00:00 is added by default

updated_date_utc_tostring

UTC end date for the warehouse last-updated filter (exclusive). Filters rows whose underlying warehouse record changed strictly before this instant. If hour and minute are not specified, 00:00 is added by default

Example request

{
  "updated_date_utc_from": "2026-05-24 00:00",
  "updated_date_utc_to": "2026-05-25 00:00"
}

Response

Request was created successfully but is still running asynchronously.

messagestring required

Message about the search status

search_idstring uuid required

The search ID

Example response

{
  "message": "Asynchronous execution in progress. Use provided query id to perform query monitoring and management.",
  "search_id": "b59d4093-cbfc-4a1d-be5c-ba78d4ffbc64"
}

Changes

No recorded changes to this operation across all 1 revision of this API.