Skip to main content
GET
List Dynamic CI's decisions

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.

Query Parameters

limit
integer
default:25

Page size, between 1 and 100.

Required range: 1 <= x <= 100
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

host
string
default:github.com

The repositories' host. github.com is the only supported value today.

Example:

"github.com"

owner
string

With name, lists one repository's decisions. Without both, every repository in the organization.

Minimum string length: 1
Example:

"acme"

name
string
Minimum string length: 1
Example:

"widgets"

since
string<date-time>

Decisions made at or after this time. Defaults to 7 days before until. Trunk keeps 90 days of decisions, so an earlier time reads from 90 days ago.

Example:

"2026-11-11T00:00:00Z"

until
string<date-time>

Decisions made before this time. Defaults to now.

Example:

"2026-11-18T00:00:00Z"

workflowId
string<uuid>
Example:

"2b3c4d5e-0000-4000-8000-000000000002"

jobId
string<uuid>

A job, with its matrix variations.

Example:

"3c4d5e6f-0000-4000-8000-000000000003"

actor
string

Who triggered the run.

Minimum string length: 1
Example:

"octocat"

mode
enum<string>

The mode the decision was made in. enforced keeps evolving decisions too.

Available options:
enforced,
learning
Example:

"enforced"

recommendation
enum<string>

Dynamic CI's verdict.

Available options:
run,
skip
Example:

"run"

jobOutcome
string

Comma-separated; a decision matching any of them is kept. What the job did (passed, failed, skipped), or what that showed about the verdict: falseSkip (a skip found wrong), falseRun (a run whose job passed), skipNotTaken (an Enforced skip whose job ran).

Example:

"falseSkip,skipNotTaken"

decidedBy
string

Comma-separated; any of them. pathsFilter (the paths filter forced the run, or was the only signal that voted), vote, mustRun (another signal forced the run), neverRun (a signal forced the skip), noData (too many signals had no data).

Example:

"pathsFilter"

signalVote
string

Comma-separated <signal>:<run|skip> pairs; a decision is kept when every pair holds.

Example:

"paths-filter:skip"

falseSkipKind
enum<string>

Keeps the false skips found in their own run, or by a merge-queue run after the pull request skipped the job.

Available options:
sameRun,
mergeQueueAfterPr
Example:

"sameRun"

pullRequestNumber
integer

A pull request's decisions, its merge-queue runs included.

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

4901

commitSha
string

A commit sha or a prefix of at least 4 characters.

Pattern: ^[0-9a-fA-F]{4,40}$
Example:

"9f2c1b7"

include
enum<string>

signals adds each decision's signal votes.

Available options:
signals
Example:

"signals"

Response

A page of decisions

data
object[]
required
Maximum array length: 100
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

total
integer

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

Example:

1247

totalPages
integer

Pages of limit decisions that match the filter. Present only with includeTotal=true.

Example:

50