---
title: "Get External Session"
method: GET
path: "/api/ingest/external/v1/sessions/{source}/{source_external_id}"
tags: ["ingest"]
---

# Get External Session

`GET /api/ingest/external/v1/sessions/{source}/{source_external_id}`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/ingest/external/v1/sessions/{source}/{source_external_id}`
- Auth: none declared

Return one captured session + its messages, owner-scoped.

Powers the source/session detail pages added in TOS-256 PR-1 Phase 5.
Authorization is by ``started_by == identity_id`` - a session belonging
to another identity returns 404 (not 403) so existence can't be probed.

## Path parameters

- `source` string, required
- `source_external_id` string, required

## Query parameters

- `instance_id` string, nullable

## Headers

- `x-ingest-key` string, nullable
- `authorization` string, nullable
- `x-impersonate-identity-id` string, nullable

## Response `200`

Successful Response

- IngestSessionDetailV1: A captured session + its messages + extraction metadata. Returned by ``GET /api/ingest/external/v1/sessions/<source>/<id>``. Used by the source/session detail pages (TOS-256 PR-1 Phase 5) and by the Mind back-link surface.
  - `chat_id` string, required
  - `source` string, required
  - `source_external_id` string, required
  - `instance_id` string, nullable
  - `source_session_revision` integer, nullable, required
  - `title` string, nullable, required
  - `started_at` string, date-time, nullable, required
  - `turn_count` integer, required
  - `workspace_hint` string, nullable, required
  - `extraction_count` integer, required
  - `extraction_status` 'queued' | 'ineligible' | 'deferred' | 'processing' | 'failed' | 'integrated', required
  - `messages` IngestSessionMessageV1[], required
    - `id` string, required
    - `role` string, required
    - `content` string, required
    - `created_at` string, date-time, required
    - `author_identity_id` string, nullable, required
    - `author_display_name` string, required
    - `author_kind` string, required
    - `window_seq` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thinqos/apis/thinqos-api.md) · [All operations](https://skmtc.dev/thinqos/apis/thinqos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thinqos/apis/thinqos-api/revisions/5387b4ded614?raw)