gumloop artifacts exposes the files an agent has produced, such as reports, generated docs, and exported data. Artifacts are always scoped to an agent.
List artifacts
gumloop artifacts list agent_abcgumloop artifacts list agent_abc --session session_xyz --limit 50
Prints ID, FILENAME, VERSION, SESSION, and CREATED. If there are more results, the CLI prints the next cursor at the bottom.
Grab the agent ID from gumloop agents list and the session ID from gumloop sessions get <id> or the URL of the session in the Gumloop hub.
Flag
Description
--session
Filter to artifacts produced inside a specific session.
--limit
Maximum number of artifacts to return.
--cursor
Pagination cursor from a previous list call.
--json
Print the raw response payload.
Download an artifact
gumloop artifacts download artifact_abc
By default the CLI writes the artifact to the current directory under its original filename. Use -o to change the destination:
Flag
Description
-o, --output
File or directory to write to. Use - to write to stdout.
get calls the existing SDK artifacts.download method and returns download metadata plus its signed URL without transferring file bytes. versions discovers version history. Use the existing download command above for bytes, including a specific --version-id. Rename changes a legacy file’s display name while preserving its stored filename; --reset clears the display name. VFS files cannot be renamed or deleted through these methods. Deletion soft-deletes a legacy generated file. Python equivalents are client.artifacts.download, list_versions, rename, and delete; download accepts version_id. There is no separate SDK retrieve or content method.These methods require the corresponding backend API support. Hosting, version restoration, and script execution remain outside this client surface.
Was this page helpful?
Assistant
Responses are generated using AI and may contain mistakes.