Skip to main content
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 string length: 1

Body

application/json
agentUid
string
required

Uid of the agent to link to

Minimum string length: 1
externalUserId
string
required

User Id from external system

userEmail
string

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

Maximum string length: 100
tags
string[]

Array of tags (max 10)

Maximum array length: 10
Required string length: 1 - 60
contextUids
string[]

Array of existing context Uids (max 30)

Maximum array length: 30
Required string length: 1 - 30
mcpserverUids
string[]

Array of existing MCP server Uids (max 5)

Maximum array length: 5
Required string length: 20

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 array length: 10
Required string length: 1 - 60
contextUids
string[]

Array of existing context Uids (max 30)

Maximum array length: 30
Required string length: 1 - 30
mcpserverUids
string[]

Array of existing MCP server Uids (max 5)

Maximum array length: 5
Required string length: 20
createdAt
string<date-time>

Creation timestamp (ISO 8601)

lastUsedAt
string<date-time>

Last time used timestamp (ISO 8601)