Sessions

Sessions are containers for captured network traffic in powhttp. Each session has a unique identifier, a name and contains zero or more entries representing individual HTTP transactions. The session endpoints allow you to list all available sessions and retrieve detailed information about specific ones.

List All Sessions

Retrieves a list of all sessions currently loaded in powhttp.

GET /sessions

Response:

Array<{
  id: string;                // ULID
  name: string;              // Display name of the session
  entryIds: Array<string>;   // Array of entry ULIDs in this session
}>

Example Response:

[
  {
    "id": "01K88WXWGVPX6PHAJ868JBFF5B",
    "name": "Session 1",
    "entryIds": [
      "01K88WZ6TMNGMRB5JVZSHPSETA",
      "01K88X054ZTXG5P5D9S4G5BZS7",
      "01K88X0B6M70WFSTJHJGDRCJDX"
    ]
  },
  {
    "id": "01K88WXYMFPX7STP72JG319G0C",
    "name": "Session 2",
    "entryIds": []
  }
]

Get Specific Session

Retrieves detailed information about a single session by its ID.

GET /sessions/{session_id}

Path Parameters:

session_id: The ULID of the session, or active to reference the currently active session

Response:

{
  id: string;                // ULID
  name: string;              // Display name of the session
  entryIds: Array<string>;   // Array of entry ULIDs in this session
}

Example Request:

GET /sessions/active

Example Response:

{
    "id": "01K88WXWGVPX6PHAJ868JBFF5B",
    "name": "Session 1",
    "entryIds": [
        "01K88WZ6TMNGMRB5JVZSHPSETA",
        "01K88X054ZTXG5P5D9S4G5BZS7",
        "01K88X0B6M70WFSTJHJGDRCJDX"
    ]
}

Get Session Bookmarks

Returns a list of entry IDs for all bookmarked entries within a specific session.

GET /sessions/{session_id}/bookmarks

Path Parameters:

session_id: The ULID of the session, or active to reference the currently active session

Response:

Array<string>

Example Request:

GET /sessions/active/bookmarks

Example Response:

[
  "01K88WZ6TMNGMRB5JVZSHPSETA",
  "01K88X0B6M70WFSTJHJGDRCJDX"
]