# Retrieve a collection of agent sessions

> You're reading the Mindset v3 documentation. v3 is no longer sold; this is reference for existing customers. Mindset 4 docs are at /docs.

Mindset v3 REST API reference: Agent Sessions.

**GET** `/api/v1/appuid/{appUid}/agentsessions`

## Base URL

Requests go to your region's API host, for example `https://a.api.mindset.ai`. Hosts: `https://a.api.mindset.ai`, `https://b.api.mindset.ai`, `https://c.api.mindset.ai`, `https://d.api.mindset.ai`.

## Authorization

- `x-api-key` (string, required, header)

  Your API key.

## Path parameters

- `appUid` (string, required, path)

  Your application's uid

## Query parameters

- `startAfter` (string, query)

  Start after the given createdAt timestamp (ISO 8601) for pagination

* `externalUserId` (string, query)

  Filter results to a specific externalUserId

- `userEmail` (string, query)

  Filter results to a specific email address format user identifier. Deprecated. Prefer using externalId.

* `contextUid` (string, query)

  Filter results to a specific contextUid

- `sdkUserEmail` (string, query)

  Filter results to a specific SDK user email address

* `humanUid` (string, query)

  Filter results to a specific Mindset human UID

- `agentUid` (string, query)

  Filter results to a specific agentUid

## Responses

### 200

Successful retrieval

```json
{
  "agentsessions": [
    {
      "uid": "string",
      "agentSessionUid": "string",
      "humanUid": "string",
      "externalUserId": "string",
      "userEmail": "string",
      "agentUid": "string",
      "tags": [
        "string"
      ],
      "contextUids": [
        "string"
      ],
      "mcpserverUids": [
        "string"
      ],
      "planUids": [
        "string"
      ],
      "skillUids": [
        "string"
      ],
      "forcePlanUid": "string",
      "createdAt": "string",
      "lastUsedAt": "string"
    }
  ]
}
```

### 404

Agent Sessions not found

## Example request

```bash
curl -X GET "https://a.api.mindset.ai/api/v1/appuid/{appUid}/agentsessions" \
  -H "x-api-key: <your-api-key>"
```