Sessions

A session is used for managing a live visualization. It links users to a shareable dataset revision. Sessions are similar to shared live documents. A user might start a session, open it in another tab, and share it with another user: as long as they have the same session ID, Graphistry tries to share live updates across all users (experimental.)

Currently, sessions are created by a user visiting a page (graph.html?dataset=...), which will redirect to a new page with the session ID appended (graph.html?dataset=...&session=...). The dataset revision is initialized to the dataset.

Viewers can inspect their own session and administrators can list all sessions.

Route Method Headers Parameters Return
api/experimental/viz/sessions/ GET Content-Type: application/json
Authorization: Bearer YOUR_JWT_TOKEN
{
  "results": [ { 
      "session_id": str,
      "revision": {
        "revision_id": str,
        "dataset": {
          "dataset_id": str 
}}}] }
        
Input:

  curl -s -L -X GET \
    -H "Authorization: Bearer my_generated_token" \
    -H "Content-Type: application/json" \
    http://localhost/api/experimental/viz/sessions/
  
api/experimental/viz/sessions/<session_id>/ GET Content-Type: application/json
Authorization: Bearer YOUR_JWT_TOKEN
{ 
    "session_id": str,
    "revision": {
      "revision_id": str,
      "dataset": {
        "dataset_id": str 
}}}
          
Input:

    curl -s -L -X GET \
      -H "Authorization: Bearer my_generated_token" \
      -H "Content-Type: application/json" \
      http://localhost/api/experimental/viz/sessions/1234/