Skip to main content
GET
List agent sessions

Authorizations

X-Outerlayer-App-Id
string
header
required

Factory id the request is scoped to.

Authorization
string
header
required

API key (sk_outerlayer_*)

Query Parameters

limit
integer
default:25
Required range: 1 <= x <= 100
offset
integer | null
default:0
Required range: 0 <= x <= 10000
repo
string
Maximum string length: 500
repoScope
enum<string>

Pass "all" to list sessions across every repository instead of pinning to one. Wins over repo when both are present. A separate field from repo, so a repository literally named "all" (or "", the no-repository bucket) stays addressable via repo.

Available options:
all
branch
string
Maximum string length: 500
agentType
string
Maximum string length: 500
model
string
Maximum string length: 500
workerKind
string
Maximum string length: 500
q
string
Maximum string length: 200
actor
string
Maximum string length: 500
from
string<date-time>
to
string<date-time>
sort
enum<string>
default:startedAt
Available options:
startedAt,
cost,
errors,
turns,
steering,
toolErrorRate
dir
enum<string>
default:desc
Available options:
asc,
desc
signal
enum<string>
Available options:
hands-on,
denied,
tool-errors,
provider-errors,
clean
includeSubagents
enum<string>
Available options:
1
origin
string
pr
integer
Required range: x > 0
prRepo
string
Minimum string length: 1

Response

A page of agent sessions.

data
object
required