lossless-monorepo/agent-skills/cloudflare-artifacts-interface/references/api-map

Path
agent-skills/cloudflare-artifacts-interface/references/api-map.md

Cloudflare Artifacts — operations across every surface, tiered

Source: Cloudflare’s Artifacts docs (REST API page updated 2026-10-22, Workers binding, Wrangler commands updated 2026-05-18), fetched 2026-10-25. Tiers are this skill’s: 0 read · 1 create/write · 2 destructive · 3 account-level or lasting. See SKILL.md § Safety.

REST paths are relative to https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID. NS = /artifacts/namespaces/:namespace. All JSON uses the Cloudflare v4 envelope (result, success, errors, messages, optional result_info). File, raw, and blob routes return bytes.

Namespaces

Operation Tier REST Wrangler Binding
Create (with optional jurisdiction: "eu" | "us") 1, or 3 with a jurisdiction POST /artifacts/namespaces {namespace, jurisdiction?} — — (implicit on first create)
List 0 GET /artifacts/namespaces?limit=&cursor= artifacts namespaces list —
Get (returns namespace, jurisdiction: "unrestricted" when none was set, repo_count, created_at, updated_at; tested 2026-10-25) 0 GET NS artifacts namespaces get <NAME> —
Delete (must be empty; 409 if not) 2 DELETE NS → 204 — —

Repos

Operation Tier REST Wrangler Binding (env.ARTIFACTS, one namespace)
Create {name, description?, default_branch?, read_only?}, returns remote + token 1 POST NS/repos artifacts repos create <NAME> --namespace create(name, opts?)
List (limit ≤200, cursor, search, sort created_at|updated_at|last_push_at|name, direction) 0 GET NS/repos artifacts repos list --namespace list(opts?)
Get (includes remote, read_only, source, last_push_at) 0 GET NS/repos/:name artifacts repos get <NAME> --namespace get(name) → handle; handle.info()
Delete (202, asynchronous) 2 DELETE NS/repos/:name artifacts repos delete <NAME> --namespace (prompts unless --force) delete(name)
Fork {name, description?, read_only?, default_branch_only?} 1 POST NS/repos/:name/fork — handle.fork(name, opts?)
Import public HTTPS {url, branch?, depth?, read_only?}, asynchronous 1 (3 into a shared baseline) POST NS/repos/:name/import — import(params)

Repo content (no clone needed)

Operation Tier REST Binding
Commit history 0 GET NS/repos/:name/log?ref=&limit=&offset= handle.log(opts?)
One commit 0 GET NS/repos/:name/commit/:hash handle.readCommit(hash)
Tree 0 GET NS/repos/:name/tree/:hash handle.readTree(hash)
Blob (bytes) 0 GET NS/repos/:name/blob/:hash handle.readBlob(hash)
File at a ref (bytes, octet-stream) 0 GET NS/repos/:name/file?ref=&path= handle.readFile(args)
File at a ref (bytes, guessed type) 0 GET NS/repos/:name/raw/:ref/:path —

Repo tokens (for git only)

Operation Tier REST Wrangler Binding
Mint {repo, scope? (default **write**), ttl? (60–31,536,000 s, default 86,400)} 0 for short read; 1 for short write; 3 for write > 1 day POST NS/tokens → {id, plaintext, scope, expires_at} artifacts repos issue-token <REPO> --namespace --scope --ttl handle.createToken(scope?, ttl?)
List (state active|expired|revoked|all, per_page ≤100, page) 0 GET NS/repos/:name/tokens — handle.listTokens()
Revoke 1 (2 if another agent may hold it) DELETE NS/tokens/:id — handle.revokeToken(tokenOrId)

Git (data plane)

Operation Tier Token
clone, fetch, pull (protocol v1 and v2) 0 read or write
push (receive-pack v1 only) 1 on your own repo; 2 for force-push or ref deletion on someone else’s write

Header form (preferred; full token string): git -c http.extraHeader="Authorization: Bearer $ARTIFACTS_TOKEN" <cmd> "$ARTIFACTS_REMOTE"

URL form (one-shot only; token without ?expires=): https://x:${ARTIFACTS_TOKEN%%\?expires=*}@<ACCOUNT_ID>.artifacts.cloudflare.net/git/<ns>/<repo>.git

Worker binding config

{
  "artifacts": [{ "binding": "ARTIFACTS", "namespace": "default" }]
}
[[artifacts]]
binding = "ARTIFACTS"
namespace = "default"

One binding per namespace. Deployed Workers use the binding directly. Only local wrangler dev, deploy, and types need Wrangler to be logged in.

Limits (2026-10-21)

Control-plane rate 2,000 requests / 10 s per namespace
Git rate 2,000 requests / 10 s per repo
Storage per repo 1 GB (repos created on or after 2026-09-29); 10 GB for older repos
Storage per account 1 TB, raisable
Repos, namespaces Unlimited