---
title: "The threads of this session's task [read]"
method: GET
path: "/sessions/{id}/threads"
---

# The threads of this session's task \[read\]

`GET /sessions/{id}/threads`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/sessions/{id}/threads`
- Auth: HTTP bearer

The root session first (relation primary, parent_id null), then every member the caller may see, oldest first: helper (a pod created it), handoff (a handoff branched it), child (a client recorded it). Each thread names its source (cloud, local_mirror, imported, tycoon), its agent's harness and model, its status, and what it has spent. A session nothing created is a task of one and lists itself. See docs/asteroids/architecture/session-record.md.

## Path parameters

- `id` string, required

## Response `200`

OK

- object
  - `threads` object[]
    - `id` string
    - `parent_id` string, nullable
    - `root_id` string
    - `relation` 'primary' | 'helper' | 'handoff' | 'child'
    - `source` 'cloud' | 'local_mirror' | 'imported' | 'tycoon'
    - `agent` object
      - `id` string, nullable
      - `harness` string
      - `model` string
    - `status` string
    - `title` string, nullable
    - `usage` object
      - `spent_usd_micros` string
      - `tool_calls` integer
    - `environment` object, nullable: repo, commit, branch, instructions_hash, digest, cwd — as the creating client recorded them in metadata.environment
      - `repo` string
      - `commit` string
      - `branch` string
      - `instructions_hash` string
      - `digest` string
      - `cwd` string
    - `created_at` string, date-time

## Other responses

- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/sessions/:id/threads/get.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)