---
title: "List Sessions"
method: GET
path: "/workspaces/{workspace_id}/copilot/job-agents"
tags: ["jobs"]
---

# List Sessions

`GET /workspaces/{workspace_id}/copilot/job-agents`

## Request

- Base URL: `https://api.os3robotics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.os3robotics.com/workspaces/{workspace_id}/copilot/job-agents`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

OS3's job agent sessions in the workspace: those waiting for someone's answer first, then
the others, each the latest first, `limit` at a time; a full page sets X-Next-After, the
`after` of the next, and X-Total-Count counts them all. Continue any of them by answering on
its run (POST /jobs/{job_id}/agent/reply).

## Path parameters

- `workspace_id` string, uuid, required

## Query parameters

- `limit` integer
- `after` string, uuid, nullable

## Response `200`

Successful Response

- AgentSessionSummary[]
  - `id` string, uuid, required
  - `job_id` string, uuid, required
  - `conversation_id` string, uuid, required
  - `state` 'queued' | 'running' | 'waiting' | 'done' | 'stopped', required
  - `restarts` integer, required
  - `open_questions` integer, required
  - `waiting_on_os3` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/os3robotics/apis/os3-api.md) - [All operations](https://skmtc.dev/os3robotics/apis/os3-api/llms.txt) - [OpenAPI document](https://skmtc.dev/os3robotics/apis/os3-api/revisions/af32cd4f14bb?raw)