Levain LabsLevain Labs
API ReferenceRuns

List Run Artifacts

List files the agent published during this run, oldest first.

Files appear here once the upload finishes; intermediate state during a long-running run is reflected incrementally. Each entry includes filename, size, content type, and creation time — request a fresh download URL via GET /api/v1/runs/{run_id}/artifacts/{key}/url when ready to download.

Capped at 1000 entries per response. When the cap fires, the omitted files are whichever names sort latest in lexicographic order — not the oldest by upload time — so a run that overflowed the cap may be missing recent uploads. The visible entries are still returned in upload-time order; treat truncated=true as "this run had more than 1000 files; pagination by upload time is not currently available."

GET
/api/v1/runs/{run_id}/artifacts

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

run_id*Run Id
Formatuuid

Header Parameters

X-API-Key?string|null

Response Body

application/json

application/json

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