Levain LabsLevain Labs
API ReferenceRuns

List Run Artifacts

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

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": {}
    }
  ]
}