---
title: "List Task Artifacts"
method: GET
path: "/v1/agents/{agent_id}/tasks/{task_id}/artifacts"
tags: ["v1", "protected", "agent-tasks"]
---

# List Task Artifacts

`GET /v1/agents/{agent_id}/tasks/{task_id}/artifacts`

List files the agent explicitly published as durable artifacts.

Workspace-scoped: the task must belong to the caller's workspace, or we
return 404. Each item carries an AgentArea API download URL, so access
stays behind our auth, audit, and workspace checks instead of exposing
object-storage URLs directly.

## Path parameters

- `agent_id` string, uuid, required
- `task_id` string, uuid, required

## Query parameters

- `expires_in` integer

## Response `200`

Successful Response

- TaskArtifactItem[]
  - `content_type` string, nullable, required
  - `created_at` string, date-time, nullable, required
  - `download_url` string, required
  - `id` string, required
  - `name` string, required
  - `path` string, required
  - `sha256` string, nullable, required
  - `size` integer, required

## Other responses

- `422` — Validation Error

## Changes

> 19 revisions in range; 5 could not be searched.

- **2026-08-08** `e3650e48373b` — 1 breaking, 4 info
  - removed the required property `items/last_modified` from the response with the `200` status
  - added the required property `items/created_at` to the response with the `200` status
  - added the required property `items/id` to the response with the `200` status
  - added the required property `items/name` to the response with the `200` status
  - …1 more
- **2026-04-29** `e1a530c0a2d5` — 1 info
  - endpoint added
- **2026-03-30** `e9c153221160` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/agents/:agent_id/tasks/:task_id/artifacts/get.md)

---

[API](https://skmtc.dev/agentarea/apis/agentarea-api.md) · [All operations](https://skmtc.dev/agentarea/apis/agentarea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agentarea/agentarea-api/revisions/ac18f7025c00/schema)