List a repository's paths filters

curl --request GET \
  --url https://api.trunk.io/v2/dynamic-ci/paths-filters \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.trunk.io/v2/dynamic-ci/paths-filters', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.trunk.io/v2/dynamic-ci/paths-filters",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.trunk.io/v2/dynamic-ci/paths-filters"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.trunk.io/v2/dynamic-ci/paths-filters")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "pathsFilterId": "e8f1c2a4-5b6d-4e7f-8a9b-0c1d2e3f4a5b",
      "name": "web",
      "rules": {
        "include": [
          {
            "glob": "web/**"
          }
        ],
        "exclude": [
          {
            "glob": "web/**/*.md"
          }
        ]
      },
      "jobs": [
        {
          "workflowPath": ".github/workflows/ci.yaml",
          "jobKey": "web-unit",
          "jobId": "3c4d0b17-8e2a-4f6c-9d1b-7a5e3c2f1d0e"
        }
      ],
      "createdAt": "2026-10-26T20:31:04.512Z",
      "updatedAt": "2026-10-26T20:31:04.512Z"
    }
  ],
  "nextCursor": "AQEKZm9vYmFy",
  "hasMore": true,
  "total": 1247
}

Dynamic CI

List a repository's paths filters

Every paths filter in the repository, each with the jobs it gates. A paths filter decides which changed files make a job run, on pull requests and in the merge queue alike. An item with jobs can be sent back as one filters entry of dynamicCi.setPathsFilters, with its name, rules and jobs. A job the web app gave one filter for pull requests and another for the merge queue is listed under both: sending both items back leaves it as is, and sending one alone is a conflict, since the job also has the other filter.

GET

dynamic-ci

paths-filters

curl --request GET \
  --url https://api.trunk.io/v2/dynamic-ci/paths-filters \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.trunk.io/v2/dynamic-ci/paths-filters', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.trunk.io/v2/dynamic-ci/paths-filters",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.trunk.io/v2/dynamic-ci/paths-filters"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.trunk.io/v2/dynamic-ci/paths-filters")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "pathsFilterId": "e8f1c2a4-5b6d-4e7f-8a9b-0c1d2e3f4a5b",
      "name": "web",
      "rules": {
        "include": [
          {
            "glob": "web/**"
          }
        ],
        "exclude": [
          {
            "glob": "web/**/*.md"
          }
        ]
      },
      "jobs": [
        {
          "workflowPath": ".github/workflows/ci.yaml",
          "jobKey": "web-unit",
          "jobId": "3c4d0b17-8e2a-4f6c-9d1b-7a5e3c2f1d0e"
        }
      ],
      "createdAt": "2026-10-26T20:31:04.512Z",
      "updatedAt": "2026-10-26T20:31:04.512Z"
    }
  ],
  "nextCursor": "AQEKZm9vYmFy",
  "hasMore": true,
  "total": 1247
}

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

github.com is the only supported value today.

Example:

"github.com"

owner

string

required

Minimum string length: 1

Example:

"acme"

name

string

required

Minimum string length: 1

Example:

"widgets"

Response

A page of paths filters

data

object[]

required

Maximum array length: 100

Show child attributes

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

Resources

Skeleton group medium 3

List a repository's paths filters

Authorizations

Query Parameters

Response