Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.artifacta.io/llms.txt

Use this file to discover all available pages before exploring further.

​
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
pip install artifacta-cli gives you both the CLI and the Python SDK.

​
Authenticate

Verify it works: 
artifacta whoami
Output
Tenant:  acme-corp
Plan:    free
Key:     ...k9f7 (last 4)
Usage:   0 / 10,000 requests this month
Storage: 0 B / 1 GB

​
Push → List → Pull

1

Push a file

Upload an artifact tagged with a session ID.
artifacta push report.pdf --session demo-run
Output
✓ Uploaded art_2xk9f7v3m1p0
  Filename:  report.pdf
  Size:      245 KB
  Hash:      sha256:e3b0c44298fc1c149afbf4c8996fb9...
  Expires:   2026-04-28T10:30:00+00:00
art_2xk9f7v3m1p0
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

artifacta ls --session demo-run
Output
ARTIFACT ID         FILENAME            SIZE     CREATED              EXPIRES
art_2xk9f7v3m1p0   report.pdf          245 KB   2026-03-29 10:30     2026-04-28

1 artifact, 245 KB total
3

Pull the artifact back

artifacta pull art_2xk9f7v3m1p0
Output
✓ Downloaded report.pdf (245 KB)
  Saved to: ./report.pdf
That’s it. Your artifact is stored, deduplicated, and will auto-expire in 30 days.

​
Do the same thing in Python

from artifacta import Client

client = Client()  # reads ARTIFACTA_API_KEY from environment

# Push
artifact = client.push("report.pdf", session_id="demo-run")
print(artifact.id)  # art_2xk9f7v3m1p0

# List
for a in client.list(session_id="demo-run"):
    print(f"{a.id}: {a.filename}")

# Pull
client.pull(artifact.id, output="./downloads/")

​
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.
Agent integration tip: Set ARTIFACTA_SESSION_ID in the environment before spawning sub-agents. Every agent inherits the session automatically — zero flag passing required.