List Builds
travis.list_builds
ActionBusiness appsconnection required
Calls the Travis CI API with the connection's credentials.
Page a repository's builds, newest first.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Travis CI
- Secret shape
- the API token, or {"api_token": "…"}
- Config it needs
- base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
7 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
repository The repository as its 'owner/name' slug, or its numeric Travis repository id. | string | Yes | — | — | rails/rails |
branch Return only builds on this branch; several may be comma-separated. | string | No | — | — | main |
state Return only builds in this state, e.g. 'passed', 'failed' or 'started'. | string | No | — | — | passed |
event_type Return only builds triggered this way: push, pull_request, api or cron. | string | No | — | — | push |
limit How many builds to return; Travis caps a page at 100. | number | No | — | 1–100 | 25 |
offset How many builds to skip before this page starts. | number | No | — | ≥ 0 | 0 |
sort_by Sort order; Travis sorts by id, created_at, started_at, finished_at or number, and defaults to 'number:desc,id:desc'. | string | No | — | — | number:desc |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"branch": "main",
"event_type": "push",
"limit": 25,
"offset": 0,
"repository": "rails/rails",
"sort_by": "number:desc",
"state": "passed"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
builds One entry per build on this page. | array | — |
builds[].id The build id. | number | — |
builds[].number The build number as shown in Travis. | string | — |
builds[].state The build's current state. | string | — |
builds[].event_type What triggered the build. | string | — |
builds[].duration Wall-clock seconds the build took. | number | — |
builds[].started_at When the build started, ISO-8601. | string | — |
builds[].finished_at When the build finished, ISO-8601. | string | — |
count How many builds this page carried. | number | — |
pagination Travis's @pagination block: limit, offset, count. | object | — |
{
"builds": [
{
"duration": 0,
"event_type": "",
"finished_at": "",
"id": 0,
"number": "",
"started_at": "",
"state": ""
}
],
"count": 0,
"pagination": {}
}Related Travis CI nodes
See List Builds run in a workflow.
In a technical demo we add the Travis CI connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.