Sign in
latestOpenAPI 3.1.02026-08-223321,1001.6 MB

2134ebffd1ef

External API

Get a session

Retrieve a session and its messages by session ID.

get/v1/sessions/{session_id}

Path parameters

session_idstring uuid required

Response

Successful Response

idstring required

Unique identifier for the session.

statusstring required

Current lifecycle state of the session. One of: running (investigation in progress), idle (investigation complete, ready for follow-ups), follow_up_running (processing a follow-up message), cancelled, or failed.

titlestring nullable

Human-readable session title. Set via the title field on creation, or auto-generated by Traversal.

inputstring required

The original incident description or question that initiated this session.

created_atstring date-time required

Timestamp when the session was created, in UTC.

updated_atstring date-time nullable

Timestamp when the session was last updated, in UTC. Null if the session has not been updated since creation.

Example response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "running",
  "messages": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "confidence": "Medium",
      "confidence_explanation": "The evidence suggests a likely cause, but alternative explanations cannot be ruled out."
    }
  ]
}