POST
/
api
/
v1
/
appuid
/
{appUid}
/
agentsessions
Create a new agent session
curl --request POST \
  --url https://a.api.mindset.ai/api/v1/appuid/{appUid}/agentsessions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "agentUid": "<string>",
  "externalUserId": "<string>",
  "userEmail": "<string>",
  "tags": [
    "<string>"
  ],
  "contextUids": [
    "<string>"
  ],
  "mcpserverUids": [
    "<string>"
  ]
}'
{
  "uid": "<string>",
  "agentSessionUid": "<string>",
  "humanUid": "<string>",
  "externalUserId": "<string>",
  "userEmail": "<string>",
  "agentUid": "<string>",
  "tags": [
    "<string>"
  ],
  "contextUids": [
    "<string>"
  ],
  "mcpserverUids": [
    "<string>"
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "lastUsedAt": "2023-11-07T05:31:56Z"
}

Authorizations

x-api-key
string
header
required

Path Parameters

appUid
string
required

Your application's uid

Minimum length: 1

Body

application/json
agentUid
string
required

Uid of the agent to link to

Minimum length: 1
externalUserId
string
required

User Id from external system

userEmail
string

email address format user identifier. Deprecated. Prefer using externalId.

Maximum length: 100
tags
string[]

Array of tags (max 10)

Maximum length: 10
contextUids
string[]

Array of existing context Uids (max 30)

Maximum length: 30
mcpserverUids
string[]

Array of existing MCP server Uids (max 5)

Maximum length: 5

Response

Agent Session created successfully

uid
string

Unique ID of the agent session

agentSessionUid
string

Unique ID of the agent session

humanUid
string

Mindset internal user Uid linked to this agent sessions

externalUserId
string

External user Id

userEmail
string

External supplied user email address to identify the user

agentUid
string

Unique Agent Id linked to this agent sessions

tags
string[]

Array of tags (max 10)

Maximum length: 10
contextUids
string[]

Array of existing context Uids (max 30)

Maximum length: 30
mcpserverUids
string[]

Array of existing MCP server Uids (max 5)

Maximum length: 5
createdAt
string<date-time>

Creation timestamp (ISO 8601)

lastUsedAt
string<date-time>

Last time used timestamp (ISO 8601)