Get failure context

curl --request GET \
  --url https://api.testdino.com/api/public/v1/{projectId}/context \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.testdino.com/api/public/v1/{projectId}/context"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.testdino.com/api/public/v1/{projectId}/context', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.testdino.com/api/public/v1/{projectId}/context",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.testdino.com/api/public/v1/{projectId}/context"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.testdino.com/api/public/v1/{projectId}/context")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.testdino.com/api/public/v1/{projectId}/context")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "level": "run",
    "runId": "test_run_abc123",
    "runStatus": "completed",
    "suites": [
      {
        "suiteId": "test_suite_abc123",
        "spec": "tests/checkout.spec.ts",
        "status": "failed",
        "durationMs": 18432,
        "groupId": null
      }
    ],
    "list": [
      {
        "caseId": "test_case_abc123",
        "title": [
          "Checkout",
          "applies discount"
        ],
        "status": "failed",
        "attempt": 1,
        "totalAttempts": 2,
        "duration": 3210,
        "error": {
          "message": "Expected element to be visible",
          "stack": "Error: ...",
          "location": {
            "file": "tests/checkout.spec.ts",
            "line": 42,
            "column": 5
          },
          "snippet": "await expect(page.locator('#submit')).toBeVisible();"
        },
        "suiteId": "test_suite_abc123",
        "spec": "tests/checkout.spec.ts",
        "groupId": "0",
        "alsoFailedIn": [
          {
            "caseId": "test_case_def456",
            "suiteId": "test_suite_def456",
            "groupId": "1",
            "title": [
              "Checkout",
              "applies discount"
            ]
          }
        ]
      }
    ],
    "count": 10,
    "total": 27,
    "nextPage": 2,
    "meta": {
      "projectId": "project_abc123",
      "runId": "test_run_abc123"
    },
    "environment": {
      "framework": {
        "type": "playwright",
        "version": "1.48.0"
      },
      "platform": {
        "osName": "Linux",
        "osVersion": null,
        "browserName": null,
        "browserVersion": null
      },
      "project": "/path/to/project"
    }
  }
}

Get failure context

Bundled failure-focused snapshot at one of three granularity levels — picked by the deepest ID present in your query:

Parameter sent	`data.level`	Returns
`runId` (only)	`run`	Failing suites in the run + deduplicated cross-suite failing tests
`suiteId` (with or without `runId`)	`suite`	Failing/flaky tests within that TestSuite
`caseId` (with or without `suiteId`/`runId`)	`test`	Full debug payload for a single test attempt (error, steps, attachments)

Designed for AI agents and debugging tools: one URL, one auth check, three discriminator-tagged shapes. Start from a failing run, drill into a failing suite, or jump directly to a specific test — without round-tripping across /test-runs, /test-cases, and the artifact endpoints.

Markdown for LLMs. Append ?format=md to get a text/markdown body (not the JSON envelope) — heading-per-section rendering of Error / Failure context / Other attempts / Steps / Trace / Assets / Environment. Pair with maxLength to cap the payload for token-bounded LLM input.

Signed asset URLs. traceLink.url and assets.*.url are SAS-authenticated Azure Blob URLs that expire 1 hour after the response is generated. Re-fetch this endpoint to get fresh URLs — do not cache them.

What is NOT included. TestDino does not expose Playwright trace internals (console + network breakdown, accessibility snapshot) through this endpoint. The trace zip is surfaced as traceLink so you can open it in the Playwright trace viewer.

GET

{projectId}

context

Get failure context

curl --request GET \
  --url https://api.testdino.com/api/public/v1/{projectId}/context \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.testdino.com/api/public/v1/{projectId}/context"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.testdino.com/api/public/v1/{projectId}/context', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.testdino.com/api/public/v1/{projectId}/context",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.testdino.com/api/public/v1/{projectId}/context"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.testdino.com/api/public/v1/{projectId}/context")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.testdino.com/api/public/v1/{projectId}/context")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "level": "run",
    "runId": "test_run_abc123",
    "runStatus": "completed",
    "suites": [
      {
        "suiteId": "test_suite_abc123",
        "spec": "tests/checkout.spec.ts",
        "status": "failed",
        "durationMs": 18432,
        "groupId": null
      }
    ],
    "list": [
      {
        "caseId": "test_case_abc123",
        "title": [
          "Checkout",
          "applies discount"
        ],
        "status": "failed",
        "attempt": 1,
        "totalAttempts": 2,
        "duration": 3210,
        "error": {
          "message": "Expected element to be visible",
          "stack": "Error: ...",
          "location": {
            "file": "tests/checkout.spec.ts",
            "line": 42,
            "column": 5
          },
          "snippet": "await expect(page.locator('#submit')).toBeVisible();"
        },
        "suiteId": "test_suite_abc123",
        "spec": "tests/checkout.spec.ts",
        "groupId": "0",
        "alsoFailedIn": [
          {
            "caseId": "test_case_def456",
            "suiteId": "test_suite_def456",
            "groupId": "1",
            "title": [
              "Checkout",
              "applies discount"
            ]
          }
        ]
      }
    ],
    "count": 10,
    "total": 27,
    "nextPage": 2,
    "meta": {
      "projectId": "project_abc123",
      "runId": "test_run_abc123"
    },
    "environment": {
      "framework": {
        "type": "playwright",
        "version": "1.48.0"
      },
      "platform": {
        "osName": "Linux",
        "osVersion": null,
        "browserName": null,
        "browserVersion": null
      },
      "project": "/path/to/project"
    }
  }
}

Authorizations

Authorization

string

header

required

Project PAT (tdp_) token with public-api scope

Path Parameters

projectId

string

required

The project identifier (e.g. project_abc123). Must match the project associated with your PAT.

Query Parameters

runId

string

TestRun ID (e.g. test_run_abc123). Selects run level when sent alone. Optional when suiteId or caseId is present.

suiteId

string

TestSuite ID (e.g. test_suite_abc123). Selects suite level. Sufficient on its own — runId is resolved server-side.

caseId

string

TestCase ID (e.g. test_case_abc123). Selects test level. Sufficient on its own — suiteId and runId are resolved server-side.

attempt

integer

Zero-indexed attempt number. Test level only. Defaults to the latest attempt; returns INVALID_ATTEMPT if out of range.

Required range: x >= 0

format

enum<string>

default:json

Response format. json (default) returns the standard envelope. md returns a plain text/markdown body — useful for LLM prompts.

Available options:

json,

md

detail

enum<string>

default:default

Payload density. summary drops steps[]. compact also drops stdout/stderr and caps each assets.* array at 5 entries (a totals object is included).

Available options:

default,

compact,

summary

page

integer

default:1

1-indexed page number. Applies to run and suite levels only.

Required range: x >= 1

limit

integer

default:10

Items per page (1–50, default 10). Applies to run and suite levels only.

Required range: 1 <= x <= 50

maxLength

integer

Truncate the markdown output to N characters (1–50000). Only meaningful with format=md.

Required range: 1 <= x <= 50000

Response

Failure context at the resolved level

success

boolean

data

object

Returned when only runId is supplied.

Option 1
Option 2
Option 3

Show child attributes

Get test case history

List specs

Introduction

Token Info

Test Runs

Test Cases

Context

Specs

Test Case Explorer

Dashboard

Analytics

Manual Tests

Reports

Filters

Usage

Get failure context

Authorizations

Path Parameters

Query Parameters

Response