# AgentDrop Box Key Wait (Long Poll)

> AgentDrop Box Key Wait (Long Poll) is a paid API for AI agents from agentdrop.fyi, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-01).

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.

## Facts

- Endpoint: GET https://agentdrop.fyi/box/:box/:key/wait?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentdrop-box-key-wait-long-poll-14e2d152
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EovNosH8RW7NO8mD7ZuZ4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentdrop-box-key-wait-long-poll-14e2d152
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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}.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentdrop-box-key-wait-long-poll-14e2d152/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentdrop.fyi](https://www.zero.xyz/host/agentdrop.fyi/llms.txt)