---
title: "List or Get Artifacts"
method: GET
path: "/v1/artifacts"
tags: ["artifacts"]
---

# List or Get Artifacts

`GET /v1/artifacts`

## Request

- Base URL: `https://api.vlm.run` (the document declares no server; this is the origin it was published from)
- URL: `https://api.vlm.run/v1/artifacts`
- Auth: HTTP bearer

List or retrieve artifacts for a chat completion session or agent execution.

**List** (no ``object_id`` or ``filename``): returns a paginated JSON payload
of artifact metadata for the given ``execution_id`` or ``session_id``.

**Get** (provide ``object_id`` or ``filename``): returns the artifact bytes
or a redirect to its storage location.

## Query parameters

- `session_id` string, nullable: Session ID for the artifacts
- `execution_id` string, nullable: Execution ID for the artifacts
- `object_id` string, nullable: Object ID to retrieve a single artifact
- `filename` string, nullable: Workspace filename to retrieve a single artifact
- `limit` integer: Maximum number of items to return when listing
- `offset` integer: Number of items to skip when listing

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/vlm/apis/vlm-run-unified-server.md) · [All operations](https://skmtc.dev/vlm/apis/vlm-run-unified-server/llms.txt) · [OpenAPI document](https://skmtc.dev/vlm/apis/vlm-run-unified-server/revisions/4a68ab36546b?raw)