Read one run, step by step

Every step of the run in order with its status, its result or its error.

GET/v1/workflow-runs/{runId}

Request

curl --request GET \
  --url 'https://your-suite.grid82.app/your-app/v1/workflow-runs/<runId>' \
  --header 'Authorization: Bearer <token>'

import json
import requests

url = "https://your-suite.grid82.app/your-app/v1/workflow-runs/<runId>"
headers = {
  "Authorization": "Bearer <token>"
}

response = requests.request("GET", url, headers=headers)
print(response.json())

const response = await fetch("https://your-suite.grid82.app/your-app/v1/workflow-runs/<runId>", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <token>"
  },
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://your-suite.grid82.app/your-app/v1/workflow-runs/<runId>");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer <token>",
]);
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://your-suite.grid82.app/your-app/v1/workflow-runs/<runId>", nil)
  req.Header.Set("Authorization", "Bearer <token>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://your-suite.grid82.app/your-app/v1/workflow-runs/<runId>"))
    .header("Authorization", "Bearer <token>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://your-suite.grid82.app/your-app/v1/workflow-runs/<runId>")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer <token>"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": {
    "id": "<string>",
    "version": 123,
    "status": "<string>",
    "trigger": null,
    "startedAt": "<string>",
    "endedAt": null,
    "error": null,
    "writes": 123,
    "workflowId": "<string>",
    "output": null,
    "steps": [
      {
        "name": "<string>",
        "status": "<string>",
        "startedAt": null,
        "endedAt": null,
        "output": null,
        "error": null,
        "detail": null
      }
    ]
  }
}

{
  "error": {
    "code": "not_found",
    "message": "<string>",
    "details": {}
  }
}

Read the workflow-runs skill to diagnose a failure.

Requires the workflows:read scope. Operation my.workflows.runs.get. MCP tool my_workflows_runs_get. CLI: grid82 my workflows runs get (npx grid82).

Path parameters

Name	Type	Required	Description
`runId`	string	yes

Response

application/json

Success

dataobjectrequired

Show child attributes

data.idstringrequired

data.versionintegerrequired

data.statusstringrequired

data.triggerstringnullrequired

data.startedAtstringrequired

data.endedAtstringnullrequired

data.errorstringnullrequired

data.writesintegerrequired

data.workflowIdstringrequired

data.outputobjectrequired

data.stepsobject[]required

Show child attributes

data.steps.namestringrequired

data.steps.statusstringrequired

data.steps.startedAtstringnullrequired

data.steps.endedAtstringnullrequired

data.steps.outputobjectrequired

data.steps.errorstringnullrequired

data.steps.detailstringnullrequired

{ "data": { "id": "<string>", "version": 123, "status": "<string>", "trigger": null, "startedAt": "<string>", "endedAt": null, "error": null, "writes": 123, "workflowId": "<string>", "output": null, "steps": [ { "name": "<string>", "status": "<string>", "startedAt": null, "endedAt": null, "output": null, "error": null, "detail": null } ] } }

Read one run, step by step

Path parameters

Response

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown