> ## Documentation Index
> Fetch the complete documentation index at: https://docs.testdino.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TestDino Public API

> REST access to test runs, manual test cases, analytics, and project health, plus write endpoints for manual testing.

The TestDino Public API provides REST access to test runs, manual test cases, analytics, and project health data, plus write endpoints for creating and updating manual-testing entities (suites, cases, releases, sessions, and manual runs). Use it to pull test data into internal dashboards, build custom reports, drive manual testing from your own tooling, or integrate TestDino into your CI/CD.

Writes require a PAT whose owner holds a writer role (owner, admin, or member) on the project's organization. A viewer-role token can read but gets `403` on any write.

## Base URL

```text theme={null}
https://api.testdino.com/api/v1/public
```

Every endpoint is scoped to a single project, so every request URL includes a `{projectId}` segment after the base:

```text theme={null}
https://api.testdino.com/api/v1/public/{projectId}/test-runs
https://api.testdino.com/api/v1/public/{projectId}/dashboard
https://api.testdino.com/api/v1/public/{projectId}/analytics/summary
```

Replace `{projectId}` with the ID of the project you want to query. Your PAT must have access to that project.

## What's covered

| Section | Use it to |
| :- | :- |
| [Token Info](/api-reference/endpoints/token-info/verify-token) | Verify a PAT and read project/org metadata |
| [Dashboard](/api-reference/endpoints/dashboard/get-dashboard) | Project health overview |
| [Test Runs](/api-reference/endpoints/test-runs/list-test-runs) | List and drill into Playwright test runs |
| [Test Cases](/api-reference/endpoints/test-cases/get-test-case-details) | Inspect automated test cases and execution history |
| [Specs](/api-reference/endpoints/specs/list-specs) | Surface spec file health (flakiness, duration, pass rate) |
| [Test Case Explorer](/api-reference/endpoints/test-case-explorer/explore-test-cases) | Aggregated metrics across runs |
| [Debug Bundle](/api-reference/endpoints/debug-bundle/get-debug-bundle) | Bundled debugging payload for AI agents and CI scripts |
| [Analytics](/api-reference/endpoints/analytics/analytics-summary) | Summary metrics and performance trends |
| [Manual Tests](/api-reference/endpoints/manual-tests/list-manual-test-cases) | Read, create & update manual suites and cases |
| [Releases](/api-reference/endpoints/releases/list-releases) | List, create & update releases (milestones) |
| [Sessions](/api-reference/endpoints/sessions/list-sessions) | List, create & update exploratory sessions |
| [Manual Runs](/api-reference/endpoints/manual-runs/list-manual-runs) | List & create manual runs, record per-case verdicts |
| [Webhooks](/api-reference/webhooks) | Subscribe to run events & inspect delivery history |
| [Reports](/api-reference/endpoints/reports/generate-pdf-report) | Generate PDF reports |
| [Filters](/api-reference/endpoints/filters/get-filter-values) | Discover environments, branches, developers, tags |
| [Usage](/api-reference/endpoints/usage/get-usage) | Subscription usage and project allocation |

## API standards

Every endpoint follows the same patterns for authentication, pagination, date filtering, and errors. Read [API Standards](/api-reference/conventions) once and you won't need to re-read it per endpoint.

<CardGroup cols={3}>
  <Card title="Authentication" icon="key" href="/api-reference/conventions#authentication">
    Bearer PAT, scoped to your projects.
  </Card>

  <Card title="Rate limits" icon="gauge-high" href="/api-reference/conventions#rate-limits">
    100/min read, 60/min write, 200/min IP.
  </Card>

  <Card title="Response format" icon="brackets-curly" href="/api-reference/conventions#response-format">
    Success and error envelope shape.
  </Card>

  <Card title="Errors" icon="triangle-exclamation" href="/api-reference/conventions#errors">
    Codes, statuses, retry guidance.
  </Card>

  <Card title="Pagination" icon="list-ol" href="/api-reference/conventions#pagination">
    `page` / `limit` iteration.
  </Card>

  <Card title="Date filtering" icon="calendar" href="/api-reference/conventions#date-filtering">
    `dateRange` or `startDate`/`endDate`.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.