---
title: "Record Teams Open In Traversal"
method: POST
path: "/sessions/{session_id}/engagement/open-in-traversal"
---

# Record Teams Open In Traversal

`POST /sessions/{session_id}/engagement/open-in-traversal`

## 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/{session_id}/engagement/open-in-traversal`
- Auth: none declared

Record that an authenticated user followed a tagged session link.

## Path parameters

- `session_id` string, uuid, required

## Request body

- RecordOpenInTraversalRequest: Which tagged link the web app followed.
  - `engagement_source` 'teams_open_in_traversal' | 'slack_open_in_traversal' | 'teams_channel_agent' | 'slack_channel_agent', required: Query-param values the web app uses to attribute a landing.

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

## Changes

> 66 revisions in range; 9 not diffed.

- **2026-09-30** `4fa2a4911e01`: 1 breaking
  - added required request body

[Operation history](https://skmtc.dev/traversal/apis/traversal-api/changes/sessions/:session_id/engagement/open-in-traversal/post.md)

---

[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)