Mindset v3 / Deploy in your app / Agent Sessions

Retrieve a collection of agent sessions

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-keystringheaderrequired

Your API key.

Path parameters

appUidstringpathrequired

Your application's uid

Query parameters

startAfterstringquery

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

externalUserIdstringquery

Filter results to a specific externalUserId

userEmailstringquery

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

contextUidstringquery

Filter results to a specific contextUid

sdkUserEmailstringquery

Filter results to a specific SDK user email address

humanUidstringquery

Filter results to a specific Mindset human UID

agentUidstringquery

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>"