TestDino Developer Portal

The TestDino developer portal is the entry point for programmatic access: the REST API, the machine-readable OpenAPI specification, the MCP server for AI agents, and the credentials each one needs.

Quick Reference

Resource	Where	Best for
API quickstart	Guide	Your first authenticated request
OpenAPI specification	`openapi.json`	Client generation, agent tool definitions
API keys	Guide	Creating a `td_pat_` token
API standards	Reference	Auth, pagination, rate limits, errors
MCP server	Reference	Giving an AI agent live test data
Sandbox	Live app	Trying the product without your own data

Machine-readable endpoints

Agents and code generators can fetch these directly. No authentication is required to read them.

File	URL	Contents
OpenAPI (JSON)	`https://docs.testdino.com/openapi.json`	All 40 operations, typed parameters, response schemas
OpenAPI (YAML)	`https://docs.testdino.com/openapi.yaml`	Same specification in YAML
Page index	`https://docs.testdino.com/llms.txt`	Every documentation page with a description
Page topic map	`https://docs.testdino.com/llms-full.txt`	Same index plus per-page topics
MCP manifest	`https://docs.testdino.com/.well-known/mcp.json`	Documentation MCP server discovery

Every operation in the specification carries a unique operationId, a description, typed parameters, and a response schema, so it converts directly into LLM function-calling definitions.

Authenticate

TestDino has 2 authentication paths. Which one you use depends on the surface you call.

Surface	Method	Credential
REST API	Bearer token	Personal access token (`td_pat_`)
Remote MCP server	OAuth 2.0 authorization code with PKCE	Issued by the OAuth flow
Local MCP server	Environment variable	Personal access token (`td_pat_`)

The REST API uses a personal access token sent as a Bearer token on every request.

curl https://api.testdino.com/api/v1/public/{projectId}/token-info \
  -H "Authorization: Bearer $TESTDINO_PAT"

Create a PAT from User Settings → Personal Access Tokens, granting it access to the specific organizations and projects it may read. Full workflow: Generate API keys.

OAuth 2.0 for the remote MCP server

The remote MCP server at https://mcp.testdino.com authenticates over OAuth 2.0. An agent that supports remote MCP discovers the endpoints from standard metadata, so no manual token handling is needed.

Metadata document	URL
Authorization server	`https://mcp.testdino.com/.well-known/oauth-authorization-server`
Protected resource	`https://mcp.testdino.com/.well-known/oauth-protected-resource`
OpenID configuration	`https://mcp.testdino.com/.well-known/openid-configuration`

The server supports the authorization_code grant with S256 PKCE, dynamic client registration, and the mcp scope. The local MCP server uses a PAT from the TESTDINO_PAT environment variable instead.

Error handling

Every error returns JSON with a stable error.code, an HTTP status, and a human-readable message. Branch on error.code, not on status alone.

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing Authorization: Bearer token"
  }
}

The full code table, retry guidance, and rate-limit headers are in API standards.

Rate limits

Scope	Limit
Reads per token	100 requests/minute
Writes per token	60 requests/minute
Manual run creation	10 requests/minute
Pre-auth per IP	200 requests/minute
PDF generation	1 request/minute

Authenticated responses carry RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset; requests rejected before authentication do not. Back off on 429 and 5xx only.

API Reference

Every endpoint, grouped by resource.

MCP Server

Connect an AI agent to live test data.

Generate API Keys

Create and scope a td_pat_ token.

Introduction

Token Info

Test Runs

Test Cases

Context

Specs

Test Case Explorer

Dashboard

Analytics

Manual Tests

Releases

Sessions

Manual Runs

Reports

Filters

Usage

Quick Reference

Machine-readable endpoints

Authenticate

OAuth 2.0 for the remote MCP server

Error handling

Rate limits

API Reference

MCP Server

Generate API Keys

​Quick Reference

​Machine-readable endpoints

​Authenticate

​OAuth 2.0 for the remote MCP server

​Error handling

​Rate limits

​Related

API Reference

MCP Server

Generate API Keys

Quick Reference

Machine-readable endpoints

Authenticate

OAuth 2.0 for the remote MCP server

Error handling

Rate limits

Related