Retrieve metadata for a single immutable artifact version.
Endpoint
GET /agents/sessions/{session_id}/artifacts/{artifact_id}
Returns metadata for the specified artifact. A successful call returns 200 and does not return file content.
Path parameterssession_idstring (required)Session that owns the artifactartifact_id string (required)Artifact version ID from the list response, not a file_id or snapshot IDNo request body. | Request example |
Response fieldsidstringArtifact version ID, not a file_idobject stringArtifact object type, fixed as agent.session.artifactsession_id stringOwning sessionenvironment_id stringSource environmentturn_id stringSource turnpath stringFull sandbox path when the artifact was generatedsize_bytes integerFile size in bytescreated_at integerCreation time, Unix secondsThe detail response does not return underlying storage identifiers, signed download URLs, or credentials. | Response example |
Error codes
| HTTP status | Error type / code | Solution |
|---|---|---|
404 | not_found_error / not_found_error | Use an artifact ID that exists and has not been deleted in the current workspace |
{"error":{"type","code","message","param"}}. Gateway errors can use a different structure.