{"uid":"cap_EovNosH8RW7NO8mD7ZuZ4","slug":"agentdrop-box-key-wait-long-poll-14e2d152","name":"AgentDrop Box Key Wait (Long Poll)","description":"Block until {key} in box {box} has a seq greater than since (query since=, default 0), up to timeout= seconds (max 25). Returns the item, or {\"value\":null,\"timed_out\":true}.","url":"https://agentdrop.fyi/box/:box/:key/wait?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["box","key"],"properties":{"box":{"type":"string"},"key":{"type":"string"}}},"queryParams":{"type":"object","properties":{"since":{"type":"integer"},"timeout":{"type":"number"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_68KW6w7TNfi0ROZ5cOMok","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Long-polls until a specific key in a named box has a sequence number greater than a given value, returning the item or a timeout signal after up to 25 seconds.","exampleAgentPrompt":"Wait up to 20 seconds for a new message to appear on key 'task-result' in box 'box_abc123' — I'm expecting it to have arrived after sequence 5.","exampleUseCases":[{"title":"Agent task result handoff","prompt":"Block until key 'job-42-result' in box 'box_myagentpool' has been updated past sequence 0, and give me the value when it arrives — wait up to 20 seconds."},{"title":"Real-time inter-agent coordination","prompt":"I have two agents working together — wait on key 'step2-ready' in box 'pipeline_box' for a new value past sequence 3, timeout after 15 seconds if nothing shows up."},{"title":"Waiting for human approval signal","prompt":"Pause and listen on key 'approval' in box 'box_humanloop' until it gets a new entry after sequence 0, give me whatever comes back or tell me if it times out after 25 seconds."}],"resultDescription":"Returns the stored item at the key (including its value and sequence number) once a new sequence greater than 'since' is available, or a JSON object with {\"value\":null,\"timed_out\":true} if the timeout elapses before any update arrives.","failureModes":["Timeout reached before key update: returns {\"value\":null,\"timed_out\":true} after up to 25 seconds","Box or key does not exist: may return null or empty response","Invalid 'since' parameter type: request rejected","Timeout parameter exceeds 25-second maximum: capped or rejected","Payment not provided or insufficient: 402 Payment Required","Network interruption during long-poll: connection drops with no result"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to synchronize with another agent or process by blocking until a shared key is updated — ideal for producer/consumer patterns, approval workflows, or task result handoffs where polling would be wasteful. Prefer this over periodic polling because it returns immediately when data is ready and only charges per resolved call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:42:53.121Z","isFirstParty":false,"canonicalSlug":"agentdrop-box-key-wait-long-poll-14e2d152"}