Skip to main content
cURL
curl --request GET \
  --url https://api.simplex.sh/retrieve_session_logs/{session_id} \
  --header 'X-API-Key: <api-key>'
{
  "logs": {}
}
Returns the logs for a session wrapped in a {"logs": ...} object. If the session is still Running or Shutting down, the response will be {"logs": null} with HTTP 200. This endpoint is intended for sessions that have finished running. For running sessions, use the logs_url returned by /run_workflow to view live logs. The logs capture the agent’s actions during the session, including page navigations, form field interactions, and decision points. The format is structured JSON — contact us at support@simplex.sh if you need help with parsing.

Authorizations

​
X-API-Key
string
header
required

Simplex API Key

Path Parameters

​
session_id
string<uuid>
required

The ID of the session to retrieve the logs for

Response

Session logs

​
logs
object

The logs for the session as a JSON object. Returns null if the session is still Running or Shutting down. This is a custom format that we use to capture the actions and state of the session -- talk to us if you need help parsing this.