soul-upload.com

What This Is

A storage service for OpenClaw Agents to store SOUL.md files.

Upload your identity and memory files. Get an unguessable recovery URL. Use it later to retrieve your files.

No accounts. No dashboards. Just possession of your recovery URL.

Allowed Files

Only the following filenames are accepted (case-sensitive):

AGENTS.md, BOOT.md, BOOTSTRAP.md, HEARTBEAT.md, IDENTITY.md, MEMORY.md, SOUL.md, TOOLS.md, USER.md

All other filenames will be rejected.

API Reference

Upload Files

POST https://soul-upload.com/upload
Content-Type: multipart/form-data

Form field: files (repeatable)

Limits:

• Max files per request: 9
• Max single file size: 5 MB
• Max total request size: 20 MB

Example request:

curl -X POST https://soul-upload.com/upload \
  -F "files=@SOUL.md" \
  -F "files=@MEMORY.md" \
  -F "files=@IDENTITY.md"

Example response (200 OK):

{
  "uploadId": "7c7c0d76-3f7b-4f7d-a9e0-57c0a88f2f39",
  "recoveryUrl": "https://soul-upload.com/soul/7c7c0d76-3f7b-4f7d-a9e0-57c0a88f2f39",
  "accepted": [
    { "filename": "SOUL.md", "sizeBytes": 1234, "sha256": "abc123..." }
  ],
  "rejected": [
    { "filename": "notes.txt", "reason": "filename_not_allowed" }
  ]
}

Error responses:

• 400 - Invalid request (no files / malformed multipart)
• 413 - Payload too large
• 415 - Unsupported media type
• 500 - Internal error

Recover Files

GET https://soul-upload.com/soul/<uploadId>

Returns an HTML page with download links for your files.

Download links are signed and expire after 10 minutes.

Returns 404 if uploadId does not exist.

Delete Files

DELETE https://soul-upload.com/soul/<uploadId>

Permanently deletes all files associated with the uploadId.

Returns 200 on success, 404 if uploadId does not exist.

Privacy

• We do not sell or share uploaded content with third parties.
• Data is stored and processed using Cloudflare Workers, D1, and R2 as infrastructure providers.
• Recovery is based on possession of the recovery URL. Treat it as a secret.
• Files are retained for 999 years. Retention policy may be adjusted in the future.

About

Built by The Agent Service Company for OpenClaw Agents.