{"openapi":"3.1.0","info":{"title":"Dropzone API","version":"1.0.0","description":"Single-use encrypted links for text and files. A drop can be opened exactly once; opening it deletes it. No authentication required. /api/upload and /api/retrieve encrypt on the server (convenience); /api/drops is end-to-end (callers encrypt locally, see /llms.txt for the format). Agents should also read /llms.txt."},"servers":[{"url":"https://dropzone.sh"}],"paths":{"/api/upload":{"post":{"operationId":"createDrop","summary":"Encrypt text or a file and get a single-use link","parameters":[{"name":"filename","in":"query","required":false,"schema":{"type":"string"},"description":"Filename for raw-body uploads"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"Text/secret to share"},"content_base64":{"type":"string","description":"Base64 file bytes"},"filename":{"type":"string"}}}},"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"},"text":{"type":"string"}}}},"application/octet-stream":{"schema":{"type":"string","format":"binary"}},"text/plain":{"schema":{"type":"string"}}}},"responses":{"201":{"description":"Drop created","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Single-use share link"},"retrieveUrl":{"type":"string","description":"API URL returning raw contents (consumes the drop)"},"kind":{"type":"string","enum":["text","file"]},"filename":{"type":["string","null"]},"size":{"type":"integer"},"singleUse":{"type":"boolean"}}}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"413":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/drops":{"post":{"operationId":"storeCiphertext","summary":"Store an end-to-end encrypted (v2) drop","description":"Body is the ciphertext produced locally (format in /llms.txt). Append #<key> to the returned url yourself.","requestBody":{"required":true,"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"responses":{"201":{"description":"Stored","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"}}}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"413":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/drops/{id}":{"post":{"operationId":"claimCiphertext","summary":"Return a drop's ciphertext exactly once, then delete it","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Ciphertext","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Drop never existed or was already opened","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/retrieve":{"get":{"operationId":"openDrop","summary":"Decrypt and permanently delete a drop (single use)","description":"DESTRUCTIVE: succeeds once. Pass the share link as `url`, or `path` + `key`.","parameters":[{"name":"url","in":"query","schema":{"type":"string"},"description":"Full share link incl. #key (URL-encoded)"},{"name":"id","in":"query","schema":{"type":"string"}},{"name":"path","in":"query","schema":{"type":"string"},"description":"Legacy /decrypt links only"},{"name":"key","in":"query","schema":{"type":"string"}},{"name":"format","in":"query","schema":{"type":"string","enum":["raw","json"]}}],"responses":{"200":{"description":"Decrypted contents (raw bytes, or JSON when format=json)","content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["text","file"]},"filename":{"type":["string","null"]},"mimeType":{"type":"string"},"size":{"type":"integer"},"text":{"type":"string"},"content_base64":{"type":"string"}}}},"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"Drop never existed or was already opened","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}}}}