---
title: "Get Session Suggestions"
method: GET
path: "/sessions/suggestions"
---

# Get Session Suggestions

`GET /sessions/suggestions`

## 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/sessions/suggestions`
- Auth: none declared

Get session suggestions for the user based on recent ServiceNow tickets.
Returns up to 20 valid session suggestions from ServiceNow tickets.
Valid suggestions must have at least one context item.

## Response `200`

Successful Response

- GetSessionSuggestionsResponse: Response for session suggestions API.
  - `suggestions` SessionSuggestion[], required
    - `session_id` string, required
    - `organization_id` string, required
    - `incident_description` string, nullable, required
    - `incident_time` string, nullable, required
    - `incident_timezone` string, nullable, required
    - `services_context` ServiceContext[], nullable, required
      - `id` string, required
      - `name` string, required
      - `description` string, nullable
    - `relevant_context_ids` string[], nullable, required
    - `context_items` ContextItem[]
      - `id` string, required
      - `organization_id` string, required
      - `context_item_name` 'central_id' | 'function' | 'application' | 'service' | 'team' | 'url_endpoint' | 'correlation_id' | 'topology_node' | 'account' | 'storage' | 'environment' | 'cluster' | 'snow_alert' | 'snow_incident' | 'snow_problem' | 'snow_change_request' | 'customer_journey' | 'domain' | 'mim_id' | 'monitor_id', required: Enum for context item names.
      - `value` string, required
      - `metadata` object, required
    - `ambiguous_context_items` AmbiguousContextItem[]
      - `ambiguous_value` string, required
      - `context_item_names` ContextItemName[], required
    - `service_now_incident_ticket_id` string, nullable, required
    - `status` 'idle' | 'running' | 'cancelled' | 'failed' | 'follow_up_running': Session status is the status of the session. Based on Google AIP: https://google.aip.dev/216#common-states IDLE: The session is idle. RUNNING: The session is running. FOLLOW_UP_RUNNING: The follow up session is running. CANCELLED: The session is cancelled.
    - `source` 'thousand_eyes' | 'app_dynamics' | 'service_now' | 'elastic' | 'splunk' | 'datadog' | 'grafana' | 'prometheus' | 'opensearch' | 'amex_emim' | 'traversal_inci', required
    - `created_at` string, nullable, required

---

[API](https://skmtc.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)