[{"data":1,"prerenderedAt":350},["ShallowReactive",2],{"navigation":3,"\u002Fapi\u002Fenqueue":115,"\u002Fapi\u002Fenqueue-surround":345},[4,36,57,88,104],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":35},"Getting Started","i-lucide-rocket","\u002Fgetting-started","1.getting-started",[10,15,20,25,30],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-info",{"title":16,"path":17,"stem":18,"icon":19},"Install","\u002Fgetting-started\u002Finstall","1.getting-started\u002F2.install","i-lucide-download",{"title":21,"path":22,"stem":23,"icon":24},"Quickstart","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F3.quickstart","i-lucide-zap",{"title":26,"path":27,"stem":28,"icon":29},"Testing","\u002Fgetting-started\u002Ftesting","1.getting-started\u002F4.testing","i-lucide-flask-conical",{"title":31,"path":32,"stem":33,"icon":34},"CLI","\u002Fgetting-started\u002Fcli","1.getting-started\u002F5.cli","i-lucide-terminal",false,{"title":37,"icon":38,"path":39,"stem":40,"children":41,"page":35},"Concepts","i-lucide-boxes","\u002Fconcepts","2.concepts",[42,47,52],{"title":43,"path":44,"stem":45,"icon":46},"SQL-first contract","\u002Fconcepts\u002Fsql-first-contract","2.concepts\u002F1.sql-first-contract","i-lucide-database",{"title":48,"path":49,"stem":50,"icon":51},"Jobs and status","\u002Fconcepts\u002Fjobs-and-status","2.concepts\u002F2.jobs-and-status","i-lucide-list-checks",{"title":53,"path":54,"stem":55,"icon":56},"Fencing and settles","\u002Fconcepts\u002Ffencing-and-settles","2.concepts\u002F3.fencing-and-settles","i-lucide-shield",{"title":58,"icon":59,"path":60,"stem":61,"children":62,"page":35},"API","i-lucide-code-2","\u002Fapi","3.api",[63,68,73,78,83],{"title":64,"path":65,"stem":66,"icon":67},"Enqueue","\u002Fapi\u002Fenqueue","3.api\u002F1.enqueue","i-lucide-plus-circle",{"title":69,"path":70,"stem":71,"icon":72},"Claim and heartbeat","\u002Fapi\u002Fclaim-and-heartbeat","3.api\u002F2.claim-and-heartbeat","i-lucide-hand",{"title":74,"path":75,"stem":76,"icon":77},"Worker and handlers","\u002Fapi\u002Fworker-and-handlers","3.api\u002F3.worker-and-handlers","i-lucide-cpu",{"title":79,"path":80,"stem":81,"icon":82},"HTTP facade","\u002Fapi\u002Fhttp-facade","3.api\u002F4.http-facade","i-lucide-globe",{"title":84,"path":85,"stem":86,"icon":87},"Authorization","\u002Fapi\u002Fauthorization","3.api\u002F5.authorization","i-lucide-key-round",{"title":89,"icon":90,"path":91,"stem":92,"children":93,"page":35},"Operations","i-lucide-activity","\u002Foperations","4.operations",[94,99],{"title":95,"path":96,"stem":97,"icon":98},"Housekeeping","\u002Foperations\u002Fhousekeeping","4.operations\u002F1.housekeeping","i-lucide-timer",{"title":100,"path":101,"stem":102,"icon":103},"Redrive and dead letters","\u002Foperations\u002Fredrive-and-dlq","4.operations\u002F2.redrive-and-dlq","i-lucide-rotate-ccw",{"title":105,"icon":106,"path":107,"stem":108,"children":109,"page":35},"Reference","i-lucide-book-marked","\u002Freference","5.reference",[110],{"title":111,"path":112,"stem":113,"icon":114},"Configuration","\u002Freference\u002Fconfiguration","5.reference\u002F1.configuration","i-lucide-settings",{"id":116,"title":64,"body":117,"description":338,"extension":339,"links":340,"meta":341,"navigation":342,"path":65,"seo":343,"stem":66,"__hash__":344},"docs\u002F3.api\u002F1.enqueue.md",{"type":118,"value":119,"toc":333},"minimark",[120,129,134,185,232,236,245,272,278,282,314,329],[121,122,123,124,128],"p",{},"Every enqueue returns a structured ",[125,126,127],"code",{},"EnqueueResult",". Never infer success from a missing id.",[130,131,133],"h2",{"id":132},"statuses-01","Statuses (0.1)",[135,136,137,150],"table",{},[138,139,140],"thead",{},[141,142,143,147],"tr",{},[144,145,146],"th",{},"Status",[144,148,149],{},"Meaning",[151,152,153,168],"tbody",{},[141,154,155,161],{},[156,157,158],"td",{},[125,159,160],{},"created",[156,162,163,164,167],{},"New row inserted (",[125,165,166],{},"created=True",")",[141,169,170,175],{},[156,171,172],{},[125,173,174],{},"existed",[156,176,177,178,181,182,167],{},"Active ",[125,179,180],{},"(queue, idempotency_key)"," already present (",[125,183,184],{},"created=False",[186,187,192],"pre",{"className":188,"code":189,"language":190,"meta":191,"style":191},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","result = await tq.enqueue(\n    DOUBLE,\n    {\"value\": 3},\n    idempotency_key=\"demo:3\",\n)\nassert result.status in {\"created\", \"existed\"}\n","python","",[125,193,194,202,208,214,220,226],{"__ignoreMap":191},[195,196,199],"span",{"class":197,"line":198},"line",1,[195,200,201],{},"result = await tq.enqueue(\n",[195,203,205],{"class":197,"line":204},2,[195,206,207],{},"    DOUBLE,\n",[195,209,211],{"class":197,"line":210},3,[195,212,213],{},"    {\"value\": 3},\n",[195,215,217],{"class":197,"line":216},4,[195,218,219],{},"    idempotency_key=\"demo:3\",\n",[195,221,223],{"class":197,"line":222},5,[195,224,225],{},")\n",[195,227,229],{"class":197,"line":228},6,[195,230,231],{},"assert result.status in {\"created\", \"existed\"}\n",[130,233,235],{"id":234},"uniqueness-in-01","Uniqueness in 0.1",[121,237,238,239,241,242,244],{},"Reject-only on active ",[125,240,180],{},". Duplicate key → ",[125,243,174],{},".",[121,246,247,248,251,252,255,256,259,260,259,263,266,267,271],{},"Modes such as ",[125,249,250],{},"replace",", ",[125,253,254],{},"preserve_run_at",", and statuses like ",[125,257,258],{},"replaced"," \u002F ",[125,261,262],{},"skipped_locked",[125,264,265],{},"conflict"," are ",[268,269,270],"strong",{},"0.2+ design"," — not on the current wire surface.",[121,273,274,277],{},[125,275,276],{},"concurrency_key"," is separate: it caps parallel runners; it is not an enqueue identity key.",[130,279,281],{"id":280},"options","Options",[121,283,284,287,288,251,291,251,294,251,297,251,299,302,303,306,307,310,311,244],{},[125,285,286],{},"TaskQ.enqueue"," accepts optional ",[125,289,290],{},"scheduled_at",[125,292,293],{},"priority",[125,295,296],{},"lease_seconds",[125,298,276],{},[125,300,301],{},"affinity_key",", retry overrides, ",[125,304,305],{},"headers",", and a transactional ",[125,308,309],{},"session"," or ",[125,312,313],{},"connection",[121,315,316,317,320,321,324,325,328],{},"Also available: ",[125,318,319],{},"enqueue_many"," (one result per input, in order) and ",[125,322,323],{},"enqueue_raw"," (requires ",[125,326,327],{},"validate_job_types=False",").",[330,331,332],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":191,"searchDepth":198,"depth":204,"links":334},[335,336,337],{"id":132,"depth":204,"text":133},{"id":234,"depth":204,"text":235},{"id":280,"depth":204,"text":281},"Typed enqueue results and 0.1 uniqueness.","md",null,{},{"icon":67},{"title":64,"description":338},"Yk1hZi0oloPo1GcoW_k65SDdiedBTVmxZR56vRMAq9M",[346,348],{"title":53,"path":54,"stem":55,"description":347,"icon":56,"children":-1},"Attempt IDs, typed settle races, and handler return values.",{"title":69,"path":70,"stem":71,"description":349,"icon":72,"children":-1},"How workers lease work and extend ownership.",1784549299452]