Skip to main content
POST
https://jwhite.tail8bf327.ts.net
/
api
/
v1
/
sessions
/
{id}
/
start
Start Session by ID
curl --request POST \
  --url https://jwhite.tail8bf327.ts.net/api/v1/sessions/{id}/start \
  --header 'x-api-key: <api-key>'
{
  "success": true,
  "message": "Session started successfully"
}

​
Authentication

Requires API key authentication (x-api-key header). 
x-api-key: ah_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

​
Path Parameters

​
id
string
required
The ID of the session to start

​
Request

POST https://jwhite.tail8bf327.ts.net/api/v1/sessions/sess_01H3Z8G9YR3K2N5M6P7Q8W4T/start
x-api-key: ah_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

​
Response

{
  "success": true,
  "message": "Session started successfully"
}

{
  "success": false,
  "error": "Session not found"
}

{
  "success": false,
  "error": "Session is already started"
}

{
  "success": false,
  "error": "Cannot start an ended session"
}

​
Behavior

  • Sets the started_at timestamp to the current time
  • Changes session status from created to started
  • Returns an error if the session is already started
  • Returns an error if the session has already ended
  • Only the session owner can start their own sessions

​
Session Status Flow

created → started → ended
  1. Create a session using Create Session
  2. Start the session using this endpoint
  3. End the session using End Session