Skip to main content

​
Get your API key

Sign up at app.artifacta.io and copy your API key from the onboarding screen. Keys start with ak_live_.
Your full API key is shown only once at creation time. Copy it immediately.

​
Install

pip install artifacta-cli gives you both the CLI and the Python SDK.

​
Authenticate

Best for agents and CI — every sub-process inherits the key automatically.
Verify it works:
Output

​
Push → List → Pull

1

Push a file

Upload an artifact tagged with a session ID.
Output
The human-readable block prints to stderr; the trailing artifact ID prints to stdout so you can pipe it: artifacta push report.pdf | xargs artifacta pull.
2

List artifacts in the session

Output
3

Pull the artifact back

Output
That’s it. Your artifact is stored, deduplicated, and will auto-expire in 30 days. To keep a run’s conversation beside the files it produced, follow the session transcript guide.

​
Do the same thing in Python

​
What to try next

Multi-Agent Pipeline

Coordinate artifact handoffs across agents using sessions and metadata.

CLI Reference

Full reference for every CLI command, flag, and environment variable.

Python SDK

Push dicts, pull bytes, and manage sessions from Python.

REST API

Integrate from any language with the REST API.

Use Cases

See end-to-end patterns: client-ready reports, scheduled publishing, agent-to-agent handoff.

Blog

Deep dives on agent artifact workflows.
Agent integration tip: Set ARTIFACTA_SESSION_ID in the environment before spawning sub-agents. Every agent inherits the session automatically — zero flag passing required.