Skip to main content
GET
Learn more about Box SDK versioning strategy.

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

box-version
enum<string>
required

Version header.

Available options:
2026.0

Query Parameters

source
enum<string>
required

Restricts the list to AI sessions with this origin. The only supported value is api.

Available options:
api
marker
string

The position marker at which to begin returning results, as returned in next_marker by the previous page. Omit it for the first page. All other parameters must match the request that returned the marker.

sort
enum<string>
default:updated_at

The field to sort results by. Possible values are created_at, updated_at, and name. Default is updated_at, which advances on each turn of session activity.

Available options:
created_at,
updated_at,
name
direction
enum<string>
default:desc

The direction to sort results in, either ascending (asc) or descending (desc). Default is desc.

Available options:
asc,
desc
limit
integer<int32>
default:100

The maximum number of AI sessions to return per page. The maximum is 100; larger values are treated as 100. The server may return fewer entries than requested.

Required range: x >= 1
client_ids
string[]

A comma-separated list of OAuth client IDs. Restricts the list to AI sessions created by any of these applications. Client IDs that match no application are ignored, so the response is an empty list if none of them match. Empty entries are ignored, and an empty value is treated as if the parameter were not provided.

Response

Returns a paginated list of AI sessions.

A paginated list of AI sessions.

entries
AI session · object[]
required

A list of AI sessions. The list is empty when there are no results.

limit
integer<int64>
required

The limit that was used for these entries. This will be the same as the limit query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.

Example:

1000

next_marker
string | null
required

The marker for the start of the next page of results.

Example:

"JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii"

Last modified on November 17, 2026