List Session Artifacts

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

List immutable generated outputs for this Session. Artifact IDs are opaque, Session-scoped handles; pass the returned ID unchanged to the download endpoint. Unknown or repeated query parameters return 400.

Path parameters

stringsession_idrequired

Session ID (ses_ prefix).

Query parameters

Optional<integer>limit

Page size from 1 to 100; invalid values return 400.

Default: 20

Optional<string>order

asc or desc.

Default: desc

Optional<string>after

Artifact ID returned as last_id on the previous page. Keep the same order when continuing.

Artifact object

stringobjectrequired

Always agent.session.artifact.

stringidrequired

Opaque art_ handle. Do not construct or decode it.

stringsession_idrequired

Owning Session ID.

stringpathrequired

Generated output path below /workspace/outputs/.

integersize_bytesrequired

Artifact size in bytes.

integercreated_atrequired

Creation timestamp in Unix seconds.

curl --fail-with-body 'https://api.sandbase.ai/v1/agents/sessions/ses_5b0e7c3a-91d2-5f4e-8a6b-2c9d4e1f7a83/artifacts' \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

Response200 OK

{
  "object": "list",
  "data": [
    {
      "object": "agent.session.artifact",
      "id": "art_example_handle",
      "session_id": "ses_5b0e7c3a-91d2-5f4e-8a6b-2c9d4e1f7a83",
      "path": "/workspace/outputs/report.md",
      "size_bytes": 1024,
      "created_at": 1791273600
    }
  ],
  "has_more": false,
  "first_id": "art_example_handle",
  "last_id": "art_example_handle"
}

The example handle is illustrative. Use the id returned by your own request for Download Artifact. When has_more is true, send after=last_id for the next page. first_id and last_id are null for an empty list. A separate artifact metadata GET endpoint is not exposed.