Skip to main content
GET
/
workflow-version-execution-results
Get Workflow Version Execution Results
curl --request GET \
  --url https://api.promptlayer.com/workflow-version-execution-results \
  --header 'X-API-KEY: <api-key>'
{
  "Node 1": {
    "status": "SUCCESS",
    "value": "First node result",
    "error_message": null,
    "raw_error_message": null,
    "is_output_node": false
  },
  "Node 2": {
    "status": "SUCCESS",
    "value": "Final result",
    "error_message": null,
    "raw_error_message": null,
    "is_output_node": true
  }
}
Retrieve the execution results of a specific Agent version. You can include all output nodes by setting the return_all_outputs query parameter to true.
StatusMeaning
200Execution is complete. All nodes have reached a final status (SUCCESS, FAILED, or SKIPPED).
202Execution is still running. At least one node is in a non-final status (QUEUED or RUNNING).
The response body schema is the same for both status codes. Poll until you receive a 200. Please note that this feature was previously called “Workflows” and is now called “Agents”. Some references to “Workflows” remain in our SDK and will be updated before the feature exits beta. 
{
  "Node 1": {
    "status": "SUCCESS",
    "value": "First node result",
    "error_message": null,
    "raw_error_message": null,
    "is_output_node": false
  },
  "Node 2": {
    "status": "SUCCESS",
    "value": "Final result",
    "error_message": null,
    "raw_error_message": null,
    "is_output_node": true
  }
}

Authorizations

​
X-API-KEY
string
header
required

Headers

​
X-API-KEY
string
required

Your API key for authentication.

Query Parameters

​
workflow_version_execution_id
integer<int64>
required

The unique identifier of the workflow version execution whose results you want to retrieve.

​
return_all_outputs
boolean
default:false

When set to true, the response includes all output nodes' results. If omitted or set to false, only the main output is returned.

Response

Successful response with execution results.

​
{key}
object