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

# Get one AdminAgentSession

> Retrieve a single AdminAgentSession record by its Id.

An AdminAgentSession represents a conversation session between an admin user and the AI assistant within the Nexudus admin panel. Each session is linked to a specific Business and User (the operator), identified by a unique SessionId. Sessions track the conversation channel (Chat or API), status, and metadata such as page context.

## Authentication

> [!NOTE]
>
> This endpoint requires OAuth2 authentication. Include a valid bearer token in the `Authorization` header.
> The authenticated user must be a full unrestricted administrator or have the **`AdminAgentSession-Read`** role.

## Path Parameters

**id** `integer` *required*

The Id of the AdminAgentSession record to retrieve.

## Code Examples

```bash cURL theme={null}
curl -X GET \
  "https://spaces.nexudus.com/api/sys/adminagentsessions/87654321" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://spaces.nexudus.com/api/sys/adminagentsessions/87654321',
  {
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const record = await response.json();
```

```python Python theme={null}
import requests

response = requests.get(
    'https://spaces.nexudus.com/api/sys/adminagentsessions/87654321',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN'
    }
)

record = response.json()
```

## Response

### 200

**BusinessId** `integer`

The business property.

**UserId** `integer`

The user property.

**UserFullName** `string`

Display value for User.FullName..

**UserEmail** `string`

Display value for User.Email..

**SessionId** `string`

The sessionid property.

**Title** `string`

The title property.

**Channel** `integer`

The channel property.

**StartedOn** `string`

The startedon property.

**LastActivityOn** `string`

The lastactivityon property.

**Status** `integer`

The status property.

**Metadata** `string`

The metadata property.

**Mode** `integer`

Default routing of messages: Agent (assistant answers everything) or Chat (people talk, the assistant only answers when mentioned).

**LastMessagePreview** `string`

First characters of the most recent message (set automatically).

**Id** `integer`

Unique record identifier.

**UniqueId** `string`

UUID of the record.

**CreatedOn** `string`

Date and time the record was created (ISO 8601).

**UpdatedOn** `string`

Date and time the record was last updated (ISO 8601).

**UpdatedBy** `string`

Email of the user who last updated this record.

**IsNew** `boolean`

Whether the record was recently created.

**SystemId** `string`

External system identifier.

```json Example Response theme={null}
{
  "BusinessId": 0,
  "UserId": 0,
  "UserFullName": null,
  "UserEmail": null,
  "SessionId": null,
  "Title": null,
  "Channel": 0,
  "StartedOn": "2025-01-15T10:30:00Z",
  "LastActivityOn": "2025-01-15T10:30:00Z",
  "Status": 0,
  "Metadata": null,
  "Mode": 0,
  "LastMessagePreview": null,
  "Id": 87654321,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "CreatedOn": "2025-01-10T08:00:00Z",
  "UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "UpdatedBy": "admin@example.com",
  "IsNew": false,
  "SystemId": null,
  "ToStringText": "AdminAgentSession Example",
  "LocalizationDetails": null,
  "CustomFields": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.