Skip to main content
POST
/
api
/
v1
/
capture-session
Capture session
curl --request POST \
  --url https://api.agnost.ai/api/v1/capture-session \
  --header 'Content-Type: application/json' \
  --header 'X-Org-Id: <api-key>' \
  --data '
{
  "session_id": "my-session-123",
  "user_data": {
    "user_id": "u-456",
    "email": "user@example.com"
  },
  "connection_type": "http",
  "tools": [
    "search_web",
    "get_weather"
  ]
}
'
{
  "session_id": "<string>"
}

Authorizations

​
X-Org-Id
string
header
required

Organization ID (UUID) — used by SDKs for event ingestion

Body

application/json
​
session_id
string

Unique session identifier (normalized to UUID internally)

Example:

"my-session-123"

​
user_data
object
Example:
{
  "user_id": "u-456",
  "email": "user@example.com"
}
​
connection_type
string
Example:

"http"

​
tools
string[]
Example:
["search_web", "get_weather"]

Response

Session created

​
session_id
string