> ## 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. # Quarantine tests in bulk > Quarantine up to 100 tests with 1 end date, assignee, and note. Requires a writer-role PAT. ## OpenAPI ````yaml api-reference/openapi.yml POST /{projectId}/quarantines/bulk openapi: 3.0.3 info: title: TestDino Public API version: 1.0.0 description: > Public API for TestDino: read access to test analytics, manual tests, and project data, plus manual-testing write endpoints. **Read (GET) endpoints** cover analytics, runs, cases, and project data. **Write endpoints (POST/PATCH)** create and update manual-testing entities: suites, cases, releases, sessions, and manual runs (including per-case verdicts). Query parameters are **endpoint-specific**; see each operation for supported filters, enums, and defaults. Writes require a PAT whose owner holds a writer role (owner/admin/member) on the project's organization; a viewer-role token gets `403`. ## Authentication All endpoints require a Bearer token in the `Authorization` header: ``` Authorization: Bearer td_pat_ ``` Use a user PAT (`td_pat_` prefix) scoped to the organization/project. ## Rate Limiting - **Reads (per-token):** 100 requests/minute - **Writes (per-token):** 60 requests/minute - **Manual run creation (per-token):** 10 requests/minute - **Per-IP (pre-auth):** 200 requests/minute - **PDF generation:** 1 request/minute per token Standard headers: `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` ## Response Format **Success:** ```json { "success": true, "data": { ... }, "pagination": { ... } } ``` **Error:** ```json { "success": false, "error": { "code": "ERROR_CODE", "message": "Human-readable message" } } ``` ## Time windows and date filters There is **no global date-filter convention**. Each endpoint documents its own parameters: | Endpoint family | Parameter | Allowed values | |-----------------|-----------|------------------| | Test runs list | `start_date`, `end_date` | RFC3339 timestamps (both required together) | | Explorer, specs, analytics | `days` | Integer snapped to **7, 30, or 90** (see each endpoint) | | Test runs list | — | No preset `period` / `dateRange` params | | Dashboard, filters | — | **No query params** (fixed snapshot) | ## Served by contact: name: TestDino Support url: https://docs.testdino.com servers: - url: https://api.testdino.com/api/v1/public description: Production security: - BearerAuth: [] tags: - name: Token Info description: Token introspection and project metadata - name: Test Runs description: List, inspect, and drill into test runs - name: Test Cases description: Automated test case details and history - name: Specs description: Project-level spec file health - name: Manual Tests description: Manual test suites and cases - name: Test Case Explorer description: Aggregated test case metrics explorer - name: Debug Bundle description: >- Debugging payload at 3 scopes (run, suite, test): error, steps, failure window, attempt history, artifacts, trace, deep links, and a copy-paste retry command. Designed for AI agents and CI scripts. - name: Dashboard description: Project health overview - name: Filters description: Available filter values (environments, branches, developers, tags) - name: Reports description: PDF report generation and download - name: Analytics description: Consolidated analytics summary and test case execution performance - name: Webhooks description: Outbound webhook subscriptions and delivery history - name: Usage description: Subscription usage and limits - name: Test Controls description: >- Quarantines, critical tests and test assignees: the same rules and roles as the Test Controls page. Settings are changed only in the app. paths: /{projectId}/quarantines/bulk: post: tags: - Test Controls summary: Quarantine up to 100 tests description: >- One end date, assignee and note for every test. All or nothing against the quarantine limit. Tests that cannot be quarantined are skipped and listed with why, never rejected: an unknown id is skipped as `not_found`. A retry is safe: it skips the tests the first call quarantined. operationId: bulkCreateQuarantines parameters: - $ref: '#/components/parameters/projectId' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BulkQuarantineRequest' responses: '201': description: Quarantined and skipped tests content: application/json: schema: type: object properties: success: type: boolean enum: - true data: type: object properties: created: type: array items: $ref: '#/components/schemas/Quarantine' skipped: type: array items: type: object properties: testId: type: string reason: type: string enum: - not_found - same_test - already_quarantined - critical - retired description: >- `not_found`: no such test. `same_test`: another id in the call is the same test (e.g. another browser). `already_quarantined`: its id is in `quarantineId`. `critical`: critical tests are never quarantined. `retired`: the test has not run recently. quarantineId: type: string budget: $ref: '#/components/schemas/QuarantineBudget' '400': $ref: '#/components/responses/ValidationError' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '422': description: >- BUDGET_FULL: nothing was quarantined (details.needed, details.available, details.used, details.allowed, details.capPct) content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '429': $ref: '#/components/responses/RateLimited' components: parameters: projectId: name: projectId in: path required: true schema: type: string description: >- The project identifier (e.g. `project_abc123`). Must match the project associated with your PAT. schemas: BulkQuarantineRequest: type: object required: - testIds - note additionalProperties: false properties: testIds: type: array minItems: 1 maxItems: 100 items: type: string maxLength: 128 note: type: string minLength: 1 maxLength: 1000 expiresAt: type: string format: date-time description: 'Default: the project''s default duration.' assignee: type: string maxLength: 254 description: '`me`, a user id, or a teammate''s email. Default: you.' Quarantine: type: object properties: id: type: string projectId: type: string testId: type: string description: Playwright test id logicalId: type: string description: >- The test across browsers: one quarantine covers every browser it runs on. title: type: string titlePath: type: array items: type: string filePath: type: string ownerUserId: type: string description: The assignee's user id note: type: string nullable: true issueKey: type: string nullable: true issueUrl: type: string nullable: true createdBy: type: string createdAt: type: string format: date-time expiresAt: type: string format: date-time state: type: string enum: - active - released releasedAt: type: string format: date-time nullable: true releaseReason: type: string nullable: true enum: - manual - healthy - expired - not_seen - issue_closed releasedBy: type: string nullable: true passStreak: type: integer description: Passing test runs in a row toward automatic release lastSeenAt: type: string format: date-time nullable: true version: type: integer description: Send it back when changing the quarantine. errorTemplate: type: string nullable: true description: >- Set on a known-error quarantine: only failures matching it are covered. QuarantineBudget: type: object description: The project's quarantine limit. properties: used: type: integer allowed: type: integer capPct: type: number description: Percent of active tests that may be quarantined at once. activeTests: type: integer ErrorEnvelope: type: object properties: success: type: boolean enum: - false error: type: object properties: code: type: string message: type: string responses: ValidationError: description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' Unauthorized: description: Missing, invalid, expired, or revoked token content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: success: false error: code: UNAUTHORIZED message: Invalid or unknown user PAT Forbidden: description: Token not authorized for this project content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' RateLimited: description: Rate limit exceeded headers: RateLimit-Limit: description: Max requests allowed in the current window schema: type: integer example: 100 RateLimit-Remaining: description: Requests remaining in the current window schema: type: integer example: 0 RateLimit-Reset: description: Seconds until the current window resets schema: type: integer example: 42 Retry-After: description: Seconds to wait before retrying schema: type: integer example: 60 content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: success: false error: code: RATE_LIMIT_EXCEEDED message: Too many requests securitySchemes: BearerAuth: type: http scheme: bearer description: User PAT (td_pat_) scoped to the target project ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.