Skip to main content
POST
List artifacts

Body

application/json
agent
string

Filter rich projection by agent id

fields
string

Comma-separated fields to keep on each listed item (standard listing; ignored with --rich)

includeDeleted
boolean

Include archived/deleted artifacts

kind
string

Filter by artifact kind

lifecycle
string

Filter rich projection by lifecycle: pending|running|completed|failed|archived

limit
string

Page size (default: 50, max: 500; rich max: 200)

offset
string

Number of matching artifacts to skip (default: 0)

orderBy
string

Sort by createdAt or updatedAt (default: createdAt)

rich
boolean

Return rich projection with stats and per-item lineage (task/session/agent refs). Honors --kind/--session/--task/--tag/--limit/--lifecycle/--agent; ignores --include-deleted.

session
string

Filter by session key or name

tag
string

Filter by tag

task
string

Filter by task id

Response

Success — body conforms to the @Returns schema.

artifacts
object[]
required
items
object[]
required
pagination
object
required
total
number
required
{key}
any