{"result":{"depiction_url":null,"edges":{"hasreference":{"objects":[{"created":"2026-10-07T11:13:44Z","object_id":{"id":2963,"is_a":["text","documentation","developerguide"],"name":"developer_background_work","title":{"_type":"trans","tr":{"en":"Run work outside a request"}},"uri":"https:\/\/zotonic.com\/id\/2963"},"seq":1}],"predicate":{"id":2774,"is_a":["meta","predicate"],"name":"hasreference","title":{"_type":"trans","tr":{"en":"Documentation reference"}},"uri":"https:\/\/zotonic.com\/id\/hasreference"}},"references":{"objects":[{"created":"2020-05-30T05:47:57Z","object_id":{"id":1981,"is_a":["text","documentation","reference","notification"],"name":"doc_notification_rsc_update_done","title":"observe_rsc_update_done\/2","uri":"https:\/\/zotonic.com\/id\/1981"},"seq":1000000},{"created":"2020-05-30T05:47:58Z","object_id":{"id":1353,"is_a":["text","documentation","developerguide"],"name":"doc_developerguide_modules","title":{"_type":"trans","tr":{"en":"Create a reusable module"}},"uri":"https:\/\/zotonic.com\/id\/1353"},"seq":1000000}],"predicate":{"id":332,"is_a":["meta","predicate"],"name":"references","title":{"_type":"trans","tr":{"en":"References"}},"uri":"https:\/\/zotonic.com\/id\/references"}},"subject":{"objects":[{"created":"2026-10-07T11:13:44Z","object_id":{"id":2557,"is_a":["categorization","keyword","keyword_information_type"],"name":"zotonic_topic_cookbook_recipe","title":"Cookbook recipe","uri":"https:\/\/zotonic.com\/id\/2557"},"seq":1},{"created":"2026-10-07T11:13:44Z","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-10-07T11:13:44Z","object_id":{"id":2606,"is_a":["categorization","keyword","keyword_domain"],"name":"zotonic_topic_scheduled_and_background_work","title":"Scheduled and background work","uri":"https:\/\/zotonic.com\/id\/2606"},"seq":3},{"created":"2026-10-07T11:13:44Z","object_id":{"id":2633,"is_a":["categorization","keyword","keyword_architecture"],"name":"zotonic_topic_background_task","title":"Background task","uri":"https:\/\/zotonic.com\/id\/2633"},"seq":4},{"created":"2026-10-07T11:13:44Z","object_id":{"id":2656,"is_a":["categorization","keyword","keyword_task"],"name":"zotonic_topic_schedule","title":"Schedule","uri":"https:\/\/zotonic.com\/id\/2656"},"seq":5}],"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":1578,"is_a":["text","documentation","cookbook"],"links":[{"rel":"self","target":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1578"},{"rel":"hub","target":"https:\/\/zotonic.com\/.zotonic\/websub"}],"medium":null,"medium_url":null,"name":"doc_cookbook_task_queue","page_url":{"en":"https:\/\/zotonic.com\/cookbook\/1578\/schedule-deferred-work","x-default":"https:\/\/zotonic.com\/cookbook\/1578\/schedule-deferred-work"},"preview_url":null,"resource":{"body":{"_type":"trans","tr":{"en":"<p>Create <code>src\/support\/garden_jobs.erl<\/code> in the active Garden application:<\/p>\n<pre class=\"notranslate\"><code class=\"notranslate language-erlang\">-module(garden_jobs).\n-include_lib(&quot;zotonic_core\/include\/zotonic.hrl&quot;).\n-export([report\/2]).\n\nreport(ResourceId, Context) -&gt;\n    case m_rsc:exists(ResourceId, Context) of\n        true -&gt;\n            ?LOG_INFO(#{text =&gt; &lt;&lt;&quot;Garden task completed&quot;&gt;&gt;,\n                        in =&gt; garden_jobs, id =&gt; ResourceId}),\n            ok;\n        false -&gt;\n            ok\n    end.\n<\/code><\/pre>\n<p>Compile before queueing. In a local development shell, select the site and a known practice resource:<\/p>\n<pre class=\"notranslate\"><code class=\"notranslate language-erlang\">C = z:c(garden).\nResourceId = m_rsc:rid(home, C).\nz_pivot_rsc:insert_task_after(10, garden_jobs, report,\n    &lt;&lt;&quot;garden-demo&quot;&gt;&gt;, [ResourceId], C).\n<\/code><\/pre>\n<p>Confirm <code>ResourceId<\/code> is an integer first. The queue appends the site context, so this argument list calls <code>report\/2<\/code>, not <code>report\/1<\/code>. Expect <code>{ok, TaskId}<\/code> when queued and the log message after execution. Press <strong>Ctrl-C twice<\/strong> to leave the remote shell.<\/p>\n<p>Return <code>ok<\/code> to finish. Return <code>{delay, Seconds}<\/code> to retry, or <code>{delay, Seconds, NewArgs}<\/code> to replace the next attempt&#39;s arguments. Validate arguments again when running and handle resources deleted after enqueueing.<\/p>\n<p>The key coalesces pending work for this module\/function; it does not guarantee an external effect happens exactly once. For HTTP deliveries, check transport errors <strong>and<\/strong> HTTP status, use a stable idempotency key at the destination, and limit retries. Authorize the user before enqueueing; the task&#39;s context does not preserve their request-time permissions. Do not wrap every worker in <code>sudo<\/code> to bypass this decision.<\/p>"}},"category_id":{"id":318,"is_a":["meta","category"],"name":"cookbook","title":{"_type":"trans","tr":{"en":"Cookbook"}},"uri":"https:\/\/test.zotonic.com\/id\/318"},"content_group_id":{"id":339,"is_a":["meta","content_group"],"name":"default_content_group","title":{"_type":"trans","tr":{"en":"Default Content Group"}},"uri":"https:\/\/zotonic.com\/id\/default_content_group"},"created":"2020-05-30T05:47:26Z","creator_id":{"id":336,"is_a":["person","robot"],"name":"gitbot","title":"Git","uri":"https:\/\/zotonic.com\/id\/336"},"doc_editorial_bundle":true,"doc_editorial_edges":{"hasreference":[2963],"subject":[2557,2564,2606,2633,2656]},"github_url":"https:\/\/github.com\/zotonic\/zotonic\/tree\/master\/doc\/cookbook\/task-queue.rst","is_authoritative":true,"is_dependent":false,"is_featured":false,"is_protected":false,"is_published":true,"is_unfindable":false,"language":["en"],"modified":"2026-10-07T11:13:55Z","modifier_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"name":"doc_cookbook_task_queue","pivot_geocode":null,"pivot_location_lat":null,"pivot_location_lng":null,"privacy":0,"publication_end":"9999-06-01T00:00:00Z","publication_start":"2022-02-15T10:01:42Z","slug":"schedule-deferred-work","summary":{"_type":"trans","tr":{"en":"Queue a complete callback and distinguish enqueueing from completion."}},"title":{"_type":"trans","tr":{"en":"Schedule deferred work"}},"title_slug":{"_type":"trans","tr":{"en":"schedule-deferred-work"}},"tz":"UTC","uri":null,"version":33,"visible_for":0},"uri":"https:\/\/zotonic.com\/id\/1578","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1578"}},"status":"ok"}