TRtraversal
External API

Get a session

Changed on

Retrieve a session and its messages by session ID.

get/v1/sessions/{session_id}

Request

  • Base URL
    https://api.traversal.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.traversal.com/v1/sessions/{session_id}
  • Auth
    none declared

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."
    }
  ]
}

Changes

  • 6ee9e975dda2Revision changes
    • info

      added the non-success response with the status

    • info

      removed the non-success response with the status