---
title: "Create an artifact download URL"
method: GET
path: "/sessions/agents/{sessionId}/artifacts/{artifactId}/download"
tags: ["Research Agent"]
---

# Create an artifact download URL

`GET /sessions/agents/{sessionId}/artifacts/{artifactId}/download`

Create a short-lived presigned URL for an artifact returned by the list-artifacts endpoint.

The URL expires after 30 minutes. Call this endpoint again to issue a fresh URL. Treat the URL as a credential while it is valid: do not log it or store it as a permanent share link.

### Example

```bash
curl https://elicit.com/api/v2/sessions/agents/{sessionId}/artifacts/{artifactId}/download \
  -H "Authorization: Bearer elk_live_your_key_here"
```

## Path parameters

- `sessionId` string, uuid, required
- `artifactId` string, required

## Response `200`

Short-lived artifact download URL.

- DownloadAgentSessionArtifactResponse
  - `downloadUrl` string, required — Short-lived presigned URL to download the artifact contents.
  - `expiresAt` string, required — ISO 8601 timestamp after which the download URL is no longer valid.
  - `filename` string, required — Suggested filename for the downloaded artifact.
  - `contentType` string, nullable, required — MIME type of the artifact, when known.

## Other responses

- `401` — Authentication failed. The API key is missing, invalid, revoked, or expired.
- `403` — API access is not available on your current plan. Upgrade to Pro or above to use the API.
- `404` — Research Agent API early access is not enabled, the session was not found, or the artifact is not in the session's current artifact list.
- `429` — Rate limit exceeded. More than 100 requests per minute were received from your IP address; further requests are blocked for 5 minutes.
- `500` — An unexpected error occurred. Retry after a short delay.

---

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