Data residency storage your agent can call—and verify.

Put a file. Choose a country or the strict EU zone. Get signed evidence of where its durable copies live, how it's encrypted, and the verified result when you delete it.

Check which placements accept writes now. No key needed.

curl https://api.privatefile.sh/v1/availability

privatefile — local sandbox example

$ privatefile put contract.pdf --placement country:IS \    --retention 7d --sandbox --no-inputfile_id: file_sandbox_hello_world_001operation_id: op_sandbox_put_hello_world_001idempotency_key: idem_sandbox_hello_world_001placement: country:ISprovider: Privatefile Sandbox Providersandbox: true

sandbox receipt · residency_receipt.v2

Placement
country:IS
Provider
Privatefile Sandbox Provider
Fallback
None used
Signature
Ed25519 · sandbox-signing-key-v1
Full sandbox receipt
{
  "schema_version": "residency_receipt.v2",
  "receipt_type": "residency",
  "receipt_id": "rct_sandbox_hello_world_residency_001",
  "file_id": "file_sandbox_hello_world_001",
  "operation_id": "op_sandbox_put_hello_world_001",
  "requested_placement": "country:IS",
  "selected_placement": "country:IS",
  "provider": {
    "public_name": "Privatefile Sandbox Provider",
    "provider_kind": "fake",
    "country": "IS",
    "zone": null,
    "evidence_version": "sandbox-fixture-v1"
  },
  "fallback_used": false,
  "file": {
    "sha256": "5891b5b522d5df086d0ff0b110fbd9d21bb4fc7163af34d08286a2e846f6be03",
    "size_bytes": 6
  },
  "retention": {
    "requested": "7d",
    "expires_at": "2026-08-23T00:00:00Z"
  },
  "encryption": {
    "mode": "privatefile_managed",
    "algorithm": "AES-256-GCM",
    "customer_key_id": null,
    "customer_key_fingerprint": null,
    "customer_key_fingerprint_version": null
  },
  "rate_card_version": "sandbox-2026-06-24",
  "sandbox": true,
  "issued_at": "2026-08-16T00:00:00Z",
  "signature": {
    "alg": "Ed25519",
    "key_id": "sandbox-signing-key-v1",
    "canonicalization": "json.deep_sort.v1",
    "value": "sandbox_fixture_signature_not_for_production"
  }
}

Turn an implicit infrastructure choice into an explicit control.

A location constraint can support a contractual requirement, a transfer assessment, or a voluntary privacy and jurisdiction choice. It is one control—not automatic compliance or protection from lawful access.

Compliance & contracts

Record an exact country or EU-zone constraint when a regulator, customer, grant, or negotiated term requires it.

Privacy & sovereignty

Choose where durable copies live and make international-transfer assumptions visible instead of accepting silent provider defaults.

Four separate layers

Physical location, provider jurisdiction, Privatefile's Germany control plane, and government access require separate analysis.

Why location can matter · Compare the declared placements · Review laws, intelligence partnerships, limits, and primary sources

One contract, three surfaces

HTTP

POST https://api.privatefile.sh/v1/files
Idempotency-Key: put-01

CLI

privatefile put contract.pdf \
  --placement country:IS \
  --retention 7d --sandbox --no-input

MCP

PRIVATEFILE_API_URL=https://api.privatefile.sh \
PRIVATEFILE_API_KEY="$PRIVATEFILE_API_KEY" \
  npx -y privatefile mcp

MCP tools include put_file, get_file, delete_file and get_receipt. Same storage operation contract everywhere. Agents get scoped API keys, not login pages.

Placements and pricing

rc_usd_2026_09_09_v2 · sha256 8e8e41ce… · effective 2026-09-09

Placement Storage Total read
country:CH $0.0730/GB-mo $0.050/GB
zone:EU $0.0584/GB-mo $0.040/GB
country:US $0.0438/GB-mo $0.035/GB
country:IS $0.2920/GB-mo $0.050/GB

Pricing summary. Total read combines bandwidth and retrieval meters; operation meters are not shown. GET https://api.privatefile.sh/v1/rate-card is the complete hashed billing authority. GET https://api.privatefile.sh/v1/availability reports current write availability. Prices exclude applicable tax.

Deletion returns signed absence evidence.

Privatefile reports success only after it verifies stable absence of every attributable live-provider version and records backup-expiry policy in the signed deletion receipt.

What we don't claim

Receipts are operational evidence, not compliance certificates.

A placement constrains durable objects; ingress, authorization, metadata, receipts, and encrypted transient spool run in Nuremberg, Germany.

Residency does not provide anonymity, legal immunity, or protection from valid government access.

Privatefile is not zero-knowledge storage.

Deletion receipts do not mean instant physical erasure from provider backups, logs, or archives.

There is no web file manager. That's a feature.

Fail-closed by design: a placement takes writes only while it is open and its canaries pass.

Make your first put.

The quickstart takes one file through an API key, a price quote, the upload and its residency receipt, a download, and a verified delete.