Get Run
phantombuster.get_container
ActionBusiness appsconnection required
Calls the Phantombuster API with the connection's credentials.
Read one run by its container id to see whether it has finished.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Phantombuster
- Secret shape
- the API key, or {"api_key": "…"}
- Config it needs
- org_id, base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
5 fields, 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 |
|---|---|---|---|---|---|
container_id The id of one run, as Launch Agent returns it in 'container_id'. | string | Yes | — | — | 9876543210987654 |
with_result_object Also return what the run produced, saving a separate call. | boolean | No | false | — | — |
with_output Also return the run's console output. | boolean | No | false | — | — |
with_runtime_events Also return the run's runtime events. | boolean | No | false | — | — |
with_newer_and_older_container_id Also return the ids of the runs either side of this one, for walking a Phantom's history. | boolean | No | false | — | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"container_id": "9876543210987654",
"with_newer_and_older_container_id": false,
"with_output": false,
"with_result_object": false,
"with_runtime_events": false
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
container_id The run that was read. | string | — |
container The run record as Phantombuster returned it. | object | — |
{
"container": {},
"container_id": ""
}Notes
- This is how a workflow checks on a run it queued: poll it until the run record says it has finished, then read the result.
- A run queued by Launch Agent may not have finished yet; a run still in progress answers with what it has so far rather than failing.
- The org this acts for comes from the connection's optional org_id, sent as the X-Phantombuster-Org header; leave it unset when the key already names one org.
Related Phantombuster nodes
See Get Run run in a workflow.
In a technical demo we add the Phantombuster connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.