API Quickstart

The TestDino Public API uses personal access tokens (PATs) for authentication. Every request sends the token as a Bearer header. This quickstart walks through generating a token, verifying it, and calling your first data endpoint.

Prerequisites

A TestDino account with at least one project (sign up)
Access to a project the PAT can read

Steps

Generate a PAT

Sign in to TestDino, open your profile, then User Settings
Go to Access Tokens and click Generate token
Name it, select the organizations and projects it may access, pick an expiration of 30, 60, 90, or 180 days, and create it

The td_pat_ token is shown once, so copy it right away.Full workflow: Generate API keys.

Get ProjectID

Open the project in the TestDino App
Copy the project_... segment from the URL

Eg: .../projects/project_69e1bb123.../test-runs

TipFor CI/CD or automation, export TESTDINO_API_TOKEN and TESTDINO_PROJECT_ID as env vars, and keep the token as a secret.

Verify the token

Call /token-info to confirm the token is valid and scoped correctly:

curl
Node.js
Python

curl "https://api.testdino.com/api/v1/public/$TESTDINO_PROJECT_ID/token-info" \
  -H "Authorization: Bearer $TESTDINO_API_TOKEN"

const res = await fetch(
  `https://api.testdino.com/api/v1/public/${process.env.TESTDINO_PROJECT_ID}/token-info`,
  { headers: { Authorization: `Bearer ${process.env.TESTDINO_API_TOKEN}` } }
);
const data = await res.json();
console.log(data);

import os, requests

res = requests.get(
    f"https://api.testdino.com/api/v1/public/{os.environ['TESTDINO_PROJECT_ID']}/token-info",
    headers={"Authorization": f"Bearer {os.environ['TESTDINO_API_TOKEN']}"},
)
print(res.json())

A 200 OK response with success: true confirms the setup is working.

Call a data endpoint

List the 10 most recent test runs. limit accepts 10, 25, 50, or 100:

curl
Node.js
Python

curl "https://api.testdino.com/api/v1/public/$TESTDINO_PROJECT_ID/test-runs?limit=10" \
  -H "Authorization: Bearer $TESTDINO_API_TOKEN"

const res = await fetch(
  `https://api.testdino.com/api/v1/public/${process.env.TESTDINO_PROJECT_ID}/test-runs?limit=10`,
  { headers: { Authorization: `Bearer ${process.env.TESTDINO_API_TOKEN}` } }
);
const { items, pagination } = await res.json();
console.log(`Showing ${items.length} of ${pagination.total_items} runs`);

import os, requests

res = requests.get(
    f"https://api.testdino.com/api/v1/public/{os.environ['TESTDINO_PROJECT_ID']}/test-runs?limit=10",
    headers={"Authorization": f"Bearer {os.environ['TESTDINO_API_TOKEN']}"},
)
body = res.json()
print(f"Showing {len(body['items'])} of {body['pagination']['total_items']} runs")

Troubleshooting

401 UNAUTHORIZED

The header is missing, the token does not start with td_pat_, or the token is not recognized. Check:

Header is Authorization: Bearer td_pat_... (case-sensitive, single space)
The token starts with td_pat_
The token has not been rotated or deleted in User Settings

401 TOKEN_REVOKED or 401 TOKEN_EXPIRED

The token was revoked, or it passed its expiry date. Generate a new PAT in User Settings → Access Tokens and update your stored secret.

403 FORBIDDEN: Token is not scoped to project

The token does not cover the projectId in the URL. The message reads Token is not scoped to project <id>. Use a PAT that was granted access to that project.

404 NOT_FOUND

The resource does not exist. Verify the ID in the URL.

429 RATE_LIMIT_EXCEEDED

You’ve hit the 100 requests/minute per-token limit. Wait for the RateLimit-Reset timestamp in the response headers, or implement exponential backoff. See Rate limits.

Introduction

Account

Test Runs

Test Cases

Insights

Manual Tests

Releases

Sessions

Manual Runs

Prerequisites

Steps

Troubleshooting

​Prerequisites

​Steps

​Troubleshooting

Prerequisites

Steps

Troubleshooting