Skip to main content
POST
List every quarantined test for a CI run

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer <key>. An organization admin creates one in the Trunk app under Settings → Developer → API Keys and chooses the permissions it holds. A key with none can read merge queues but change nothing in them. Permissions cover merge queues and test-result uploads, including the quarantine lookups a CI run makes before it uploads; any key can call the other Flaky Tests and Dynamic CI endpoints, including their writes.

Path Parameters

id
string
required

The collection's id: 8 alphanumeric characters.

Pattern: ^[0-9A-Za-z]{8}$
Example:

"aB3xY9kQ"

Query Parameters

limit
integer
default:25

Page size, between 1 and 25000.

Required range: 1 <= x <= 25000
Example:

25

cursor
string

Opaque cursor from a previous response's nextCursor. A cursor is bound to the operation and filter it was minted for.

Example:

"AQEKZm9vYmFy"

includeTotal
boolean
default:false

Set true to include total in the response. Costs an extra COUNT query, so it is off by default.

Example:

false

Body

application/json

The repository whose quarantined tests to list.

repo
object | null
required

The repository the tests ran in, as the CLI reads it from git. null for an upload made without a repository (--no-repo).

Response

A page of quarantined tests

data
object[]
required
Maximum array length: 25000
nextCursor
string | null
required

Opaque cursor for the next page, or null on the last page. Pass it back verbatim as cursor; do not construct or inspect one.

Example:

"AQEKZm9vYmFy"

hasMore
boolean
required

True when another page is available.

Example:

true

testCollectionUuid
string<uuid>
required

The collection's internal UUID, which a test's testId is computed from. Use it only for that: everywhere else a collection is addressed by its id.

Example:

"204b6c93-1c51-4e0f-a13c-e07b9bc60688"

repositoryId
string<uuid>
required

The repository the tests are stored under. The nil UUID for an upload without a repository, or for a repository Trunk does not know.

Example:

"7a1f0e3d-2b4c-4d5e-8f90-123456789abc"

quarantineEnabled
boolean
required

Whether quarantining is on for the collection. When it is off, no test is quarantined.

Example:

true

total
integer

Total rows matching the filter. Present only when the request set includeTotal=true.

Example:

1247