---
title: "List session artifacts"
method: GET
path: "/v2/agents/{agent_key}/sessions/{session_key}/artifacts"
tags: ["Agent Sessions"]
---

# List session artifacts

`GET /v2/agents/{agent_key}/sessions/{session_key}/artifacts`

Lists all artifacts stored in a specific agent session, with cursor-based pagination. Artifacts are files that the user uploads or that the agent generates within a session. The response lists the files in a session but does not include the file content.

## Path parameters

- `agent_key` string, required — A unique key that identifies an agent.
- `session_key` string, required — A unique key that identifies an agent session.

## Query parameters

- `metadata_filter` string
- `limit` integer
- `page_key` string
- `sort_by` 'created_at' | 'updated_at'
- `order_by` 'asc' | 'desc'

## Headers

- `Request-Timeout` integer
- `Request-Timeout-Millis` integer

## Response `200`

List of artifacts in the session.

- ListSessionArtifactsResponse — Response containing a paginated list of artifacts in a session
  - `artifacts` SessionArtifact[], required — List of artifacts in the session
    - `artifact_id` string, required — Unique identifier for the artifact
    - `filename` string, required — Original filename of the artifact
    - `mime_type` string, required — MIME type of the file
    - `size_bytes` integer, required — File size in bytes
    - `checksum_sha256` string, required — SHA-256 checksum of the file content
    - `metadata` object, required — Custom metadata associated with the artifact
    - `description` string — Optional description of the artifact
    - `ttl_days` integer — Time-to-live in days before the artifact is automatically deleted
    - `created_at` string, date-time, required — Timestamp when the artifact was created
    - `updated_at` string, date-time, required — Timestamp when the artifact was last updated
    - `data` string, byte — Base64-encoded file content (only included in single artifact fetch, not in list responses)
  - `metadata` ListMetadata, required — The standard metadata in the response of a list operation.
    - `page_key` string — The page key for the next page of results. Pass it as a query parameter to request the next page.

## Other responses

- `403` — Permissions do not allow listing artifacts in this session.
- `404` — Agent or session not found.

---

[API](https://skmtc.dev/vectara/apis/vectara-rest-api-v2.md) · [All operations](https://skmtc.dev/vectara/apis/vectara-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc.dev/vectara/apis/vectara-rest-api-v2/revisions/4557c44ba062?raw)