← Back to Stash

🗃️ Stash – API documentation

Upload files for temporary delivery. Every file expires automatically after seven days.

Source available on GitHub.

Examples

Upload one file using an API key from Keys > Stash:

curl -F "file=@./design.png" https://stash.bleech.de/upload \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Accept: application/json"

Response (on success):

{
  "id": "7f2a90e531cf8d72a091bc43",
  "url": "https://stash.bleech.de/download/7f2a90e531cf8d72a091bc43",
  "share_url": "https://stash.bleech.de/share/7f2a90e531cf8d72a091bc43",
  "expires_at": "2025-10-15T10:12:00Z",
  "filename": "design.png",
  "size": 1827443
}

Generated URLs

url serves the file directly for API usage, AI agents, embedding, and automation. Interrupted downloads can resume using HTTP byte ranges.

<img src="https://stash.bleech.de/download/7f2a90e531cf8d72a091bc43">

share_url opens a minimal page to download and permanently delete the file.

n8n Workflow Setup

• Node: HTTP Request
• Method: POST
• URL: https://stash.bleech.de/upload
• Authentication: Generic Credential Type
• Generic Auth Type: Bearer Auth
• Bearer Auth: YOUR_SECRET_KEY from Keys > Stash
• Send Body: ON
• Body Content Type: Form-Data
• Body Parameters
  • Parameter Type: n8n Binary File
  • Name: file
  • Input Data Field Name: data (or whatever your previous node uses)
• Use the returned url for direct file access or share_url for human recipients.