Get Request
postbin.get_request
ActionBusiness appsconnection required
Calls the PostBin API with the connection's credentials.
Read one collected request by id, leaving it in 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
2 fields, 2 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 |
request_id The request identifier, as postbin.send_request returns it in 'req_id'. | string | Yes | — | — | 1234567890123-9876543210987 |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"bin_id": "1234567890123-1234567890123",
"request_id": "1234567890123-9876543210987"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
req_id The collected request's identifier. | string | — |
bin_id The bin the request was collected in. | string | — |
method The HTTP method the caller used. | string | — |
path The path the caller requested, which begins with the bin id. | string | — |
headers Every header PostBin recorded, lower-cased. | object | — |
query The query-string parameters, as a flat object. | object | — |
body The request body, parsed as JSON when the caller sent JSON. | any | — |
ip The caller's IP address as PostBin saw it. | string | — |
inserted Epoch milliseconds at which PostBin stored the request. | number | — |
{
"bin_id": "",
"body": null,
"headers": {},
"inserted": 0,
"ip": "",
"method": "",
"path": "",
"query": {},
"req_id": ""
}Notes
- Reading a request does not remove it; use shift_request to consume the queue.
Related PostBin nodes
See Get 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.