Shift Oldest Request
postbin.shift_request
ActionBusiness appsconnection required
Calls the PostBin API with the connection's credentials.
Pop the oldest request off a bin's queue, removing it from the bin.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- No auth
- Providers
- PostBin
- Secret shape
- no credential — PostBin's API is public; the connection is just a host
- Config it needs
- base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
1 field, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
bin_id The bin identifier PostBin issued, as postbin.create_bin returns it in 'bin_id'. Pass the bare id, not the full bin URL. | string | Yes | — | — | 1234567890123-1234567890123 |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"bin_id": "1234567890123-1234567890123"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
found False when the bin exists but holds no requests yet; branch on this. | boolean | — |
bin_id The bin the request was taken from. | string | — |
request The popped request, or null when 'found' is false. | object | — |
request.req_id The collected request's identifier. | string | — |
request.bin_id The bin the request was collected in. | string | — |
request.method The HTTP method the caller used. | string | — |
request.path The path the caller requested, which begins with the bin id. | string | — |
request.headers Every header PostBin recorded, lower-cased. | object | — |
request.query The query-string parameters, as a flat object. | object | — |
request.body The request body, parsed as JSON when the caller sent JSON. | any | — |
request.ip The caller's IP address as PostBin saw it. | string | — |
request.inserted Epoch milliseconds at which PostBin stored the request. | number | — |
{
"bin_id": "",
"found": false,
"request": {
"bin_id": "",
"body": null,
"headers": {},
"inserted": 0,
"ip": "",
"method": "",
"path": "",
"query": {},
"req_id": ""
}
}Notes
- An empty bin is reported as found=false rather than failing the step, so a polling loop can run on a schedule.
- This removes the request from the bin; postbin.get_request leaves it in place.
Related PostBin nodes
See Shift Oldest Request run in a workflow.
In a technical demo we add the PostBin connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.