Levain LabsLevain Labs
ApiSessions

List Session Artifacts

List files this session's runs have produced.

List files this session's runs have produced.

Each entry includes filename, size, content type, creation time, and the run_id that produced it. Request a fresh download URL via GET /api/v1/runs/{run_id}/artifacts/{key}/url — the key field on each entry is the input that endpoint accepts.

Entries are grouped by run; within each run they are oldest first. Capped at 500 entries total — when a session exceeds the cap the response truncated field is true and the listing omits any run whose files were cut off by the cap, so every visible run shows its complete set. boundary_run_id names the partially-included run that was dropped, when truncation lands inside a run; runs entirely beyond the cap are not enumerated. Callers paginating across long sessions should drill into per-run listings via GET /api/v1/runs/{run_id}/artifacts.

GET
/api/v1/sessions/{session_id}/artifacts

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

session_id*Session Id
Formatuuid

Header Parameters

X-API-Key?string|null

Response Body

application/json

application/json

curl -X GET "https://api.levainlabs.com/api/v1/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08/artifacts"
{
  "artifacts": [
    {
      "key": "string",
      "run_id": "string",
      "filename": "string",
      "size_bytes": 0,
      "content_type": "string",
      "created_at": "string"
    }
  ],
  "truncated": false,
  "boundary_run_id": "string"
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}