Flaky Tests

The Trunk Flaky Tests API provides access to check the status of Trunk services and fetch quarantined tests in your project. The API is an HTTP REST API, returns JSON from all requests, and uses standard HTTP response codes.

All requests must be authenticated by providing the x-api-token header.

Get a list of quarantined tests

post

Authorizations

Body

repoobjectrequired

The repository to list quarantined tests for.

orgUrlSlugstringrequired

The slug of your organization. Find this at https://app.trunk.io/trunk/settings under "Organization Name" > "Slug"

Example: my-trunk-org-slug

pageQueryobjectrequired

Pagination options for the list of quarantined tests.

Responses

application/json

application/plain-text

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.trunk.io/v1/flaky-tests/list-quarantined-tests' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "repo": {
      "host": "github.com",
      "owner": "my-github-org",
      "name": "my-repo"
    },
    "orgUrlSlug": "my-trunk-org-slug",
    "pageQuery": {
      "pageSize": 1,
      "pageToken": ""
    }
  }'

200

401

200

{
  "quarantined_tests": [
    {
      "name": "text",
      "parent": null,
      "file": null,
      "class_name": null,
      "status": "HEALTHY",
      "code_owners": [
        "text"
      ],
      "quarantine_setting": "ALWAYS_QUARANTINE",
      "status_last_updated_at": "2025-03-18T02:26:46.998Z"
    }
  ],
  "page": {
    "total_rows": 1,
    "total_pages": 1,
    "next_page_token": "text",
    "prev_page_token": "text",
    "last_page_token": "text",
    "page_index": 1
  }
}

OK