---
title: "List session artifacts"
method: GET
path: "/v1/agents/sessions/{session_id}/artifacts"
tags: ["Sessions"]
---

# List session artifacts

`GET /v1/agents/sessions/{session_id}/artifacts`

## Request

- Base URL: `https://api.sandbase.ai`
- URL: `https://api.sandbase.ai/v1/agents/sessions/{session_id}/artifacts`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

List immutable outputs captured under /workspace/outputs/. Use returned opaque artifact IDs for after and downloads; do not construct IDs from paths.

## Query parameters

- `limit` integer
- `order` 'asc' | 'desc'
- `after` string

## Response `200`

List session artifacts

- SessionArtifactList
  - `object` 'list', required
  - `data` SessionArtifact[], required
    - `object` 'agent.session.artifact', required
    - `id` string, required: Opaque art_ handle bound to this organization and Session.
    - `session_id` string, required
    - `path` string, required: Captured output path under /workspace/outputs/.
    - `size_bytes` integer, required
    - `created_at` integer, required: Unix seconds.
  - `has_more` boolean, required
  - `first_id` string, nullable, required
  - `last_id` string, nullable, required

## Other responses

- `400`: invalid_request: invalid query parameters
- `401`: unauthorized
- `402`: spending_limit_exceeded: API key spending limit or organization balance exhausted
- `403`: insufficient_scope or org_disabled
- `404`: not_found: resource not found in this organization
- `503`: executor_unavailable, authorization_unavailable, or storage_unavailable

---

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