{"api_version":"v1","auth":{"also":"X-API-Key: \u003ctoken\u003e is accepted as well","how":"Authorization: Bearer \u003ctoken\u003e","public":["/","/healthz","/openapi.json","/llms.txt","/s/{token}","/s/{token}/info"],"scheme":"bearer","scopes":["upload","download","list","delete","share","admin"]},"conventions":["errors are always {\"error\":{\"code\",\"message\",\"hint\"}} with a stable code","every response that names a resource also carries its absolute url","uploads are identified by content: identical bytes are stored once","a retried upload of the same bytes and name returns the original file, not a copy","downloads support Range, ETag and If-None-Match"],"description":"Agent-native file exchange over a plain HTTP API. Upload, share, download. No browser required, and none provided.","docs":{"guide":"https://tempsnap.cc/llms.txt","health":"https://tempsnap.cc/healthz","openapi":"https://tempsnap.cc/openapi.json"},"endpoints":[{"method":"GET","path":"/","summary":"this document"},{"method":"GET","path":"/healthz","summary":"liveness and storage check"},{"method":"GET","path":"/openapi.json","summary":"OpenAPI 3.1 description of every endpoint"},{"method":"GET","path":"/llms.txt","summary":"plain-text guide written for agents"},{"method":"POST","path":"/v1/files","scope":"upload","summary":"upload bytes; body is the file, metadata in headers"},{"method":"PUT","path":"/v1/files","scope":"upload","summary":"same as POST"},{"method":"POST","path":"/v1/text","scope":"upload","summary":"upload a short UTF-8 string as JSON"},{"method":"PUT","path":"/v1/content/{sha256}","scope":"upload","summary":"upload and verify against a known digest"},{"method":"GET","path":"/v1/content/{sha256}","scope":"download","summary":"download bytes by digest"},{"method":"GET","path":"/v1/content/{sha256}/meta","scope":"download","summary":"does this digest exist, and how big"},{"method":"GET","path":"/v1/files","scope":"list","summary":"list files (q, tag, since, until, order, cursor)"},{"method":"GET","path":"/v1/files/{id}","scope":"download","summary":"metadata for one file"},{"method":"GET","path":"/v1/files/{id}/content","scope":"download","summary":"download bytes; supports Range and ETag"},{"method":"DELETE","path":"/v1/files/{id}","scope":"delete","summary":"delete a file and revoke its share links"},{"method":"POST","path":"/v1/shares","scope":"share","summary":"create a capability link for a file"},{"method":"GET","path":"/v1/shares","scope":"share","summary":"list share links"},{"method":"GET","path":"/v1/shares/{id}","scope":"share","summary":"metadata for one share link"},{"method":"DELETE","path":"/v1/shares/{id}","scope":"share","summary":"revoke a share link"},{"method":"POST","path":"/v1/tokens","scope":"admin","summary":"mint a scoped API token"},{"method":"GET","path":"/v1/tokens","scope":"admin","summary":"list API tokens"},{"method":"DELETE","path":"/v1/tokens/{id}","scope":"admin","summary":"revoke an API token"},{"method":"GET","path":"/v1/whoami","summary":"what this credential may do"},{"method":"GET","path":"/v1/stats","scope":"list","summary":"counts and sizes"},{"method":"GET","path":"/s/{token}","summary":"download through a share link (no credential needed)"},{"method":"GET","path":"/s/{token}/info","summary":"what is behind a share link, without spending a download"}],"limits":{"default_ttl_seconds":0,"list_page_max":1000,"max_ttl_seconds":0,"max_upload_bytes":0,"max_upload_note":"0 means unlimited: the only limit is free space on the server","proxied":{"direct_max_upload_bytes":0,"direct_url":"https://dl.tempsnap.cc","max_upload_bytes":104857600,"note":"uploads to this address above this size are rejected by the proxy in front of it, before they reach this service — the rejection is that proxy's own error, not this API's. Use a direct (non-proxied) address for larger files.","url":"https://tempsnap.cc"}},"quickstart":["upload:  curl -sS -T ./report.pdf -H \"Authorization: Bearer $TOKEN\" -H \"X-Filename: report.pdf\" -H \"X-Ttl: 7d\" https://tempsnap.cc/v1/files","share:   curl -sS -X POST -H \"Authorization: Bearer $TOKEN\" -H \"Content-Type: application/json\" -d '{\"file_id\":\"f_...\",\"ttl\":\"7d\",\"max_downloads\":3}' https://tempsnap.cc/v1/shares","fetch:   curl -sS -O -J https://tempsnap.cc/s/\u003cshare-token\u003e","list:    curl -sS -H \"Authorization: Bearer $TOKEN\" \"https://tempsnap.cc/v1/files?limit=20\u0026order=desc\"","text:    curl -sS -X POST -H \"Authorization: Bearer $TOKEN\" -H \"Content-Type: application/json\" -d '{\"name\":\"build.log\",\"content\":\"all green\"}' https://tempsnap.cc/v1/text","check:   curl -sS -H \"Authorization: Bearer $TOKEN\" https://tempsnap.cc/v1/whoami"],"service":"agentshare","version":"agentshare 28aa755 (28aa755 2026-10-10T00:07:32Z)"}