---
title: "Parse Session"
method: POST
path: "/sessions/parse"
---

# Parse Session

`POST /sessions/parse`

Parse user data to extract teams and services context using parallel LLM calls.

Args:
    request: The request containing data to parse
    authorized_user: Authorized user with roles (for RBAC checks)

Returns:
    ParseSessionResponse containing a SessionSuggestion with parsed context

## Request body

- ParseSessionRequest — Request for parsing session context from user data.
  - `data` string, required

## Response `200`

Successful Response

- ParseSessionResponse — Response for session parsing API.
  - `suggestion` APIApiSchemaSessionsSessionSuggestion, required — A suggested session with context information.
    - `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` APIApiSchemaContextItemsContextItem[]
      - `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

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/traversal/apis/fastapi.md) · [All operations](https://skmtc.net/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/traversal/fastapi/revisions/2134ebffd1ef/schema)