Download Session Artifact

GET/v1/agents/sessions/{session_id}/artifacts/{artifact_id}/content

Download a complete immutable artifact using its ID from List Session Artifacts. Files up to 200 MiB are supported. No query parameters are accepted; Range requests return 416 after access validation.

Path parameters

stringsession_idrequired

Session ID (ses_ prefix).

stringartifact_idrequired

Exact opaque art_ ID returned by this Session artifact list. Attachment IDs and workspace paths are not accepted.

Response headers

stringContent-Typerequired

Media type inferred from the file extension, or application/octet-stream.

stringContent-Dispositionrequired

attachment with the artifact filename.

integerContent-Lengthrequired

Complete file size in bytes.

stringCache-Controlrequired

no-store.

# Set SESSION_ID and ARTIFACT_ID from your Session and artifact list.
curl --fail-with-body "https://api.sandbase.ai/v1/agents/sessions/${SESSION_ID}/artifacts/${ARTIFACT_ID}/content" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  --output report.md

A successful response is the file bytes, not JSON. Download the whole file; partial transfers and resumable Range downloads are unsupported. An unavailable artifact returns 404; an unavailable artifact service returns executor_unavailable.