{"result":{"depiction_url":null,"edges":{"refers":{"objects":[{"created":"2026-11-05T18:42:38Z","object_id":{"id":1329,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_filestore","title":"mod_filestore","uri":"https:\/\/zotonic.com\/id\/1329"},"seq":1000000}],"predicate":{"id":2409,"is_a":["meta","predicate"],"name":"refers","title":{"_type":"trans","tr":{"en":"Refers"}},"uri":"https:\/\/zotonic.com\/id\/refers"}},"subject":{"objects":[{"created":"2026-11-05T18:42:38Z","object_id":{"id":2555,"is_a":["categorization","keyword","keyword_information_type"],"name":"zotonic_topic_reference","title":"Reference","uri":"https:\/\/zotonic.com\/id\/2555"},"seq":1},{"created":"2026-11-05T18:42:38Z","object_id":{"id":2564,"is_a":["categorization","keyword","keyword_audience"],"name":"zotonic_topic_backend_developer","title":"Backend developer","uri":"https:\/\/zotonic.com\/id\/2564"},"seq":2},{"created":"2026-11-05T18:42:38Z","object_id":{"id":2581,"is_a":["categorization","keyword","keyword_domain"],"name":"zotonic_topic_file_storage","title":"File storage","uri":"https:\/\/zotonic.com\/id\/2581"},"seq":3},{"created":"2026-11-05T18:42:38Z","object_id":{"id":2627,"is_a":["categorization","keyword","keyword_architecture"],"name":"zotonic_topic_notification","title":"Notification","uri":"https:\/\/zotonic.com\/id\/2627"},"seq":4}],"predicate":{"id":308,"is_a":["meta","predicate"],"name":"subject","title":{"_type":"trans","tr":{"en":"Keyword"}},"uri":"http:\/\/purl.org\/dc\/elements\/1.1\/subject"}}},"id":3139,"is_a":["text","documentation","reference","notification"],"links":[{"rel":"self","target":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/3139"},{"rel":"hub","target":"https:\/\/zotonic.com\/.zotonic\/websub"}],"medium":null,"medium_url":null,"name":"doc_notification_filestore_request","page_url":{"en":"https:\/\/zotonic.com\/docs\/3139\/observe_filestore_request-2","x-default":"https:\/\/zotonic.com\/docs\/3139\/observe_filestore_request-2"},"preview_url":null,"resource":{"version":10,"pivot_location_lat":null,"title":"observe_filestore_request\/2","is_authoritative":true,"body":"<p>Perform a direct, synchronous filestore upload, download or deletion.<\/p>\n<p>Type: <a href=\"\/id\/doc_developerguide_notifications#notification-first\">first<\/a>.<\/p>\n<p>Unlike <code>#filestore{action=upload}<\/code>, this request performs network I\/O and does not\nuse the managed upload queue. Avoid sending it while holding database locks.\nReturn <code>ok<\/code> or <code>{error, Reason}<\/code>; <code>undefined<\/code> means no observer handled the request.<\/p>\n<p><code>#filestore_request{}<\/code> properties (defined in <code>zotonic_file.hrl<\/code>):<\/p>\n<ul><li><code>action<\/code>: <code>upload<\/code>, <code>download<\/code>, or <code>delete<\/code>.<\/li><li><code>remote<\/code>: backend-relative path, resolved through <code>#filestore_credentials_lookup{}<\/code>.<\/li><li><code>local<\/code>: local source for upload or destination for download; unused for deletion.<\/li><li><code>mime<\/code>: optional upload MIME type, guessed from the local file when omitted.<\/li><li><code>handler_pid<\/code>: reserved field; the standard handler ignores it and returns the\nresult synchronously. It does not send a completion message to this PID.<\/li><\/ul>\n<p>The standard handler rejects uploads and deletions in read-only mode. Direct\nrequests do not establish managed media references or apply managed GC retention.\nSee <a href=\"\/id\/doc_module_mod_filestore\" class=\"doc-reference doc-reference-module\"><code>module#mod_filestore<\/code><\/a> for backend configuration.<\/p>","slug":"observe_filestore_request-2","is_protected":false,"visible_for":0,"tz":"UTC","language":["en"],"doc_source_hash":"0846277b007c3b322d64796a0165bc60eebc14b7b0188b487081a4cd74a55f82","is_featured":false,"notification":{"arity":2,"callbacks":[{"arity":2,"name":"observe_filestore_request","signature":"observe_filestore_request\/2","variation":"observe"}],"name":"filestore_request","record":{"action":"upload","handler_pid":"undefined","local":"undefined","mime":"undefined","remote":"undefined"}},"content_group_id":{"id":2551,"is_a":["meta","content_group"],"name":"content_group_imported_docs","title":"Imported documentation","uri":"https:\/\/zotonic.com\/id\/content_group_imported_docs"},"category_id":{"id":1122,"is_a":["meta","category"],"name":"notification","title":"Notifications","uri":"https:\/\/test.zotonic.com\/id\/1122"},"doc_source_path":"apps\/zotonic_core\/src\/behaviours\/zotonic_observer.erl","publication_start":"2026-11-05T18:42:38Z","github_url":"https:\/\/github.com\/zotonic\/zotonic\/blob\/master\/apps\/zotonic_core\/src\/behaviours\/zotonic_observer.erl","pivot_location_lng":null,"doc_source_kind":"notification","name":"doc_notification_filestore_request","is_unfindable":false,"is_published":true,"pivot_geocode":null,"created":"2026-11-05T18:42:38Z","uri":null,"doc_status":"current","is_dependent":false,"publication_end":"9999-06-01T00:00:00Z","modifier_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"privacy":0,"doc_source_commit":"becf161621dcc4de964bbf083a88aff6d3ab21ae\n","creator_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"modified":"2026-11-05T18:42:38Z","title_slug":"observe_filestore_request-2"},"uri":"https:\/\/zotonic.com\/id\/3139","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/3139"}},"status":"ok"}