> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Sessions resources

Endpoints for listing and deleting AI sessions, which hold the conversation state for interactions with Box AI agents.

## AI session

A standard representation of an AI session. An AI session holds the conversation state for a series of interactions with a Box AI agent. Its `id` is the A2A context identifier for that conversation.

> [accordion] Attributes and example
>
> | Property | Type | Required | Description |
> | - | - | - | - |
> | `type` | `enum<string>` | Yes | The value is always `ai_session`. Available options: `ai_session`. |
> | `id` | `string` | Yes | The unique identifier for the AI session. This is also the A2A `contextId` for the conversation. Treat the value as opaque. |
> | `name` | `string` | Yes | The display name of the AI session. Sessions created through the A2A API are named automatically. The value is `null` only when no name was recorded. Can be `null`. |
> | `source` | `enum<string>` | Yes | The origin of the AI session. Currently always `api`. New values may be added, so clients must tolerate values they do not recognize. Available options: `api`. |
> | `client_id` | `string` | Yes | The OAuth client ID of the application that created the AI session, as shown in the Developer Console. The value is `null` if the application is not known. Can be `null`. |
> | `created_by` | `User (Base)` | Yes | The user who created the AI session. |
> | `updated_by` | `User (Base)` | Yes | The user whose action last updated the AI session. |
> | `created_at` | `string` | Yes | The date and time when the AI session was created. |
> | `updated_at` | `string` | Yes | The date and time when the AI session was last updated. It advances on each turn of session activity, so it also serves as the most recently used ordering. |
>
> ```json Example theme={null}
> {
>   "type": "ai_session",
>   "id": "23489723",
>   "name": "a2a-126bda90-ae78-4c81-b55f-c7ed9b678a8f",
>   "source": "api",
>   "client_id": "ly1nj6n11vionaie65emwzk575hnnmrk",
>   "created_by": {
>     "id": "11446498",
>     "type": "user"
>   },
>   "updated_by": {
>     "id": "11446498",
>     "type": "user"
>   },
>   "created_at": "2026-09-01T10:30:00Z",
>   "updated_at": "2026-09-18T14:22:00Z"
> }
> ```

## AI sessions

A paginated list of AI sessions.

> [accordion] Attributes and example
>
> | Property | Type | Required | Description |
> | - | - | - | - |
> | `entries` | array of [AI session](#ai-session) | Yes | A list of AI sessions. The list is empty when there are no results. |
> | `limit` | `integer` | Yes | 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. |
> | `next_marker` | `string` | Yes | The marker for the start of the next page of results. Can be `null`. |
>
> ```json Example theme={null}
> {
>   "entries": [
>     {
>       "type": "ai_session",
>       "id": "23489723",
>       "name": "a2a-126bda90-ae78-4c81-b55f-c7ed9b678a8f",
>       "source": "api",
>       "client_id": "ly1nj6n11vionaie65emwzk575hnnmrk",
>       "created_by": {
>         "id": "11446498",
>         "type": "user"
>       },
>       "updated_by": {
>         "id": "11446498",
>         "type": "user"
>       },
>       "created_at": "2026-09-01T10:30:00Z",
>       "updated_at": "2026-09-18T14:22:00Z"
>     }
>   ],
>   "limit": 1000,
>   "next_marker": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii"
> }
> ```
