TRtraversal

Investigation V2

Changed on

Unified investigation endpoint that accepts thinking_mode parameter.

The thinking_mode parameter determines how the investigation is conducted:

  • AUTO: Uses message classifier to determine RCA vs CHAT investigation
  • DEEP: Forces RCA (root cause analysis) investigation
  • FAST: Forces CHAT (exploratory) investigation

The endpoint does not hardcode the session mode; it uses thinking_mode to determine behavior.

post/v2/investigation/new

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/v2/investigation/new
  • Auth
    none declared

Request body

user_uuidstring nullable
config_namestring required
user_messagestring required
incident_timestring required
incident_timezonestring required
relevant_context_idsstring[] nullable
output_typesInvestigationOutputTypeEnum[] nullable
trigger_type'manual' | 'auto-trigger' | 'chat_mention' | 'chat_dm' | 'chat_investigate_command' | 'chat_channel_join_auto_trigger' | 'chat_message_auto_trigger' | 'topology_explore' | 'alert_chat' | 'alert_event_manual_investigate' | 'alert_event_anomaly_detected_investigate' | 'alert_event_critical_severity_investigate' | 'proactive_followup' | 'alert_story' | 'alert_summary' | 'api' | 'mcp' | 'channel_agent' | 'deep_wiki' | 'autoresearch' | 'ensemble_member' | 'incident_monitor_postmortem' | 'slack_mention' | 'slack_dm' | 'slack_investigate_command' | 'slack_channel_join_auto_trigger' | 'slack_message_auto_trigger'
parent_session_idstring nullable
mode'rca' | 'chat' | 'triage' | 'alert_story'
thinking_mode'auto' | 'deep' | 'fast' | 'lightning' | 'ultra'

Determines the investigation depth and approach.

  • AUTO: Use message classifier to determine RCA vs CHAT
  • DEEP: Force RCA (root cause analysis) investigation
  • FAST: Force CHAT (exploratory) investigation
  • LIGHTNING: Fast, tool-rich investigation with tight iteration cap. Uses the union of all tools from fast + deep configs with a speed-focused prompt.
  • ULTRA: Same agent config as DEEP. The client-side trigger for first-turn ensembling. A no-op on follow-ups.
agent_profile'rca' | 'fix'

Which agent a session runs: its tools, prompt, budgets, and how a turn ends.

Fixed when the session is created, so every follow-up runs the same agent. Asking a different agent means starting a new session.

knowledge_version_idstring nullable
additional_instructionsstring nullable

Response

Successful Response

session_idstring required
user_chat_idstring required
system_chat_idstring required

Changes

  • c939e4d80cd7Revision changes
    • info

      added the new optional request property

    • info

      added the new chat_channel_join_auto_trigger enum value to the request property

    • info

      added the new chat_dm enum value to the request property

    • info

      added the new chat_investigate_command enum value to the request property

    • info

      added the new chat_mention enum value to the request property

    • info

      added the new chat_message_auto_trigger enum value to the request property

  • c5e1ea955e81Revision changes
    • info

      added the new ultra enum value to the request property /