Travis CI

App · 13 actions

Request Travis CI builds on any branch or commit with config overrides and see what Travis CI made of each request, list builds, and manage a repository's environment variables and cron jobs. Builds only run once a plan is selected in Travis CI.

Actions

ActionWhat it does
Create cron jobBuild a branch daily, weekly or monthly.
Create environment variableAdd an environment variable to a repository's builds, for every branch or one.
Delete cron jobDelete a repository's cron job.
Delete environment variableDelete an environment variable from a repository.
Get repositoryGet one repository: its Travis CI id, default branch, whether Travis CI builds it, and its most recently started build.
Get requestGet a build request, such as one from Trigger build: whether Travis CI approved or rejected it, its message (for a rejection, the reason, such as no plan selected), what it noticed in the config, and any builds made from it.
List branchesList the branches Travis CI knows for a repository, each with its latest build, or check one branch's status by its name.
List buildsList a repository's builds, newest first, optionally only on one branch, in some states or started by some events.
List cron jobsList a repository's cron jobs: the branch each one builds, how often, and when it runs next.
List environment variablesList a repository's environment variables: name, id, branch, and the value of each public one.
List repositoriesList the repositories you can see in Travis CI, active ones by default, with each one's id, slug, default branch and whether Travis CI builds it.
Trigger buildAsk Travis CI to build a branch, optionally a given commit, with a message and config overrides.
Update environment variableChange an environment variable's value, name, branch or whether its value shows in build logs.

Create cron job

Build a branch daily, weekly or monthly. A branch has at most one cron job, so this replaces any it already has.

Inputs

RepositoryrepositorytextRequired
The repository. Pick one, or type its owner/repo slug or Travis CI id, or paste its Travis CI URL.
BranchbranchtextRequired
The branch to build. It must exist on the code host and have been built by Travis CI before.
How oftenintervaltextRequired
How often to build the branch.One of: daily, weekly, monthly.
Skip if recently builtdont_run_if_recent_build_existstrue/false
Skip a run when the branch was built in the last 24 hours.Default: false.

Outputs

activetrue/false
Whether it is switched on
branchtext
Branch it builds
created_attext
When it was set up (ISO 8601)
dont_run_if_recent_build_existstrue/false
Whether it skips a run when the branch was built in the last 24 hours
idnumber
Cron job id
intervaltext
daily, weekly or monthly
last_runtext
When it last ran (ISO 8601)
next_runtext
When it runs next (ISO 8601)
repository_idnumber
Travis CI repository id
repository_slugtext
Repository owner and name
Example output
{
  "active": true,
  "branch": "main",
  "created_at": "2026-10-20T09:00:00Z",
  "dont_run_if_recent_build_exists": true,
  "id": 61942,
  "interval": "weekly",
  "last_run": null,
  "next_run": "2026-10-27T09:00:00Z",
  "repository_id": 25113940,
  "repository_slug": "acme/api"
}

Create environment variable

Add an environment variable to a repository's builds, for every branch or one. A private variable's value is hidden in build logs and never shown again. A name already used on the same branch is refused: use Update environment variable.

Inputs

RepositoryrepositorytextRequired
The repository. Pick one, or type its owner/repo slug or Travis CI id, or paste its Travis CI URL.
NamenametextRequired
Letters, digits and underscores, such as DEPLOY_TOKEN.
ValuevaluetextRequired
The value, kept exactly as typed.
Show value in build logspublictrue/false
Leave off for secrets: the value is then hidden in logs and Travis CI never returns it.Default: false.
Branchbranchtext
Only builds of this branch get it. Leave empty for all.

Outputs

branchtext
The only branch it applies to, or null for all
idtext
Variable id, for Update and Delete environment variable
nametext
Variable name
publictrue/false
Whether its value shows in build logs
valuetext
Its value, for a public variable only. Travis CI never returns a private one.
Example output
{
  "branch": null,
  "id": "6f1c2d3e-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
  "name": "DEPLOY_REGION",
  "public": true,
  "value": "eu-west-1"
}

Delete cron job

Delete a repository's cron job. It is checked to belong to the repository first, so a mistyped id can't remove another one.

Inputs

RepositoryrepositorytextRequired
The repository. Pick one, or type its owner/repo slug or Travis CI id, or paste its Travis CI URL.
Cron jobcron_idtextRequired
The cron job. Pick one, or paste its id from List cron jobs.

Outputs

branchtext
Branch it built
cron_idnumber
Id of the deleted cron job
deletedtrue/false
Always true: the cron job was deleted
Example output
{
  "branch": "main",
  "cron_id": 61942,
  "deleted": true
}

Delete environment variable

Delete an environment variable from a repository.

Inputs

RepositoryrepositorytextRequired
The repository. Pick one, or type its owner/repo slug or Travis CI id, or paste its Travis CI URL.
Environment variableenv_var_idtextRequired
The variable. Pick one, or paste its id from List environment variables.

Outputs

deletedtrue/false
Always true: the variable was deleted
env_var_idtext
Id of the deleted variable
Example output
{
  "deleted": true,
  "env_var_id": "6f1c2d3e-4a5b-4c6d-8e7f-9a0b1c2d3e4f"
}

Get repository

Get one repository: its Travis CI id, default branch, whether Travis CI builds it, and its most recently started build.

Inputs

RepositoryrepositorytextRequired
The repository. Pick one, or type its owner/repo slug or Travis CI id, or paste its Travis CI URL.

Outputs

activetrue/false
Whether Travis CI builds it
default_branchtext
Default branch
descriptiontext
Description from the code host
idnumber
Travis CI repository id, which every repository field accepts
languagetext
Main language, as the code host reports it
last_started_buildobject
The most recently started build, or null if it has none
nametext
Repository name
owner_nametext
Owner's login
privatetrue/false
Whether it is private
slugtext
Owner and name, such as acme/api
starredtrue/false
Whether you starred it in Travis CI
vcs_idtext
The code host's id for the repository
vcs_typetext
Code host type, such as GithubRepository
web_urltext
The repository's page in Travis CI
Example output
{
  "active": true,
  "default_branch": "main",
  "description": "Acme's public API",
  "id": 25113940,
  "language": "Python",
  "last_started_build": {
    "duration": 94,
    "event_type": "push",
    "finished_at": "2026-10-20T09:15:36Z",
    "id": 276451235,
    "number": "57",
    "previous_state": "failed",
    "pull_request_number": null,
    "pull_request_title": null,
    "started_at": "2026-10-20T09:14:02Z",
    "state": "passed"
  },
  "name": "api",
  "owner_name": "acme",
  "private": false,
  "slug": "acme/api",
  "starred": false,
  "vcs_id": "512345678",
  "vcs_type": "GithubRepository",
  "web_url": "https://app.travis-ci.com/github/acme/api"
}

Get request

Get a build request, such as one from Trigger build: whether Travis CI approved or rejected it, its message (for a rejection, the reason, such as no plan selected), what it noticed in the config, and any builds made from it.

Inputs

RepositoryrepositorytextRequired
The repository. Pick one, or type its owner/repo slug or Travis CI id, or paste its Travis CI URL.
Request IDrequest_idtextRequired
The request id Trigger build returned.

Outputs

branchtext
Branch requested
build_countnumber
How many builds were made from it
buildslist
Builds made from the request; empty until there is one
commit_messagetext
Commit message
commit_shatext
Commit requested
created_attext
When it was made (ISO 8601)
event_typetext
push, pull_request, api or cron
idnumber
Request id
messagetext
Travis CI's message about the request; for a rejected one, the reason, such as no plan selected or an unconfirmed email address
messageslist
What Travis CI noticed in the build config
repository_idnumber
Travis CI repository id
repository_slugtext
Repository owner and name
resulttext
approved or rejected, once processed
statetext
How far Travis CI has got with it, such as pending, configured or finished
Example output
{
  "branch": "main",
  "build_count": 1,
  "builds": [
    {
      "duration": 94,
      "event_type": "api",
      "finished_at": "2026-10-20T09:15:36Z",
      "id": 276451235,
      "number": "57",
      "previous_state": "failed",
      "pull_request_number": null,
      "pull_request_title": null,
      "started_at": "2026-10-20T09:14:02Z",
      "state": "passed"
    }
  ],
  "commit_message": "Bump dependencies",
  "commit_sha": "4f2a9c1e7b3d5a6f8e0c2b4d6a8f0e1c3b5d7a9f",
  "created_at": "2026-10-20T09:13:40Z",
  "event_type": "api",
  "id": 991204517,
  "message": "Nightly deploy check",
  "messages": [
    {
      "args": {
        "default": "ruby",
        "key": "language"
      },
      "code": "default",
      "key": "language",
      "level": "info",
      "line": null,
      "src": "api"
    }
  ],
  "repository_id": 25113940,
  "repository_slug": "acme/api",
  "result": "approved",
  "state": "finished"
}

List branches

List the branches Travis CI knows for a repository, each with its latest build, or check one branch's status by its name.

Inputs

RepositoryrepositorytextRequired
The repository. Pick one, or type its owner/repo slug or Travis CI id, or paste its Travis CI URL.
Branch namenametext
Only the branch with this name, such as main.
Only existing branchesexisting_onlytrue/false
Leave out branches deleted from the code host.Default: true.
Sort bysort_bytext
How to order the branches.One of: default_branch,exists_on_github,last_build:desc (Default branch first, then most recently built), last_build:desc (Most recently built first), name (Name, A to Z). Default: default_branch,exists_on_github,last_build:desc.
Page sizelimitnumber
How many to return on this page. Travis CI's default is 25.From 1 to 100.
Offsetoffsetnumber
Where the page starts: the next_offset of the page before. Leave empty for the first page.At least 0.

Outputs

brancheslist
Branches
countnumber
How many are on this page
has_moretrue/false
Whether there is another page
next_offsetnumber
Offset to ask for to get the next page, or null on the last page
offsetnumber
Where this page starts
totalnumber
How many there are in all
Example output
{
  "branches": [
    {
      "default_branch": true,
      "exists_on_github": true,
      "last_build": {
        "duration": 94,
        "event_type": "push",
        "finished_at": "2026-10-20T09:15:36Z",
        "id": 276451235,
        "number": "57",
        "previous_state": "failed",
        "pull_request_number": null,
        "pull_request_title": null,
        "started_at": "2026-10-20T09:14:02Z",
        "state": "passed"
      },
      "name": "main",
      "repository_id": 25113940,
      "repository_slug": "acme/api"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_offset": null,
  "offset": 0,
  "total": 1
}

List builds

List a repository's builds, newest first, optionally only on one branch, in some states or started by some events.

Inputs

RepositoryrepositorytextRequired
The repository. Pick one, or type its owner/repo slug or Travis CI id, or paste its Travis CI URL.
Branchbranchtext
Only builds of this branch. Leave empty for all.
Statesstatelist
Only builds in these states.One or more of: created, received, started, passed, failed, errored, canceled.
Started byevent_typelist
Only builds started by these events.One or more of: push, pull_request (Pull request), api (API request), cron (Cron job).
Sort bysort_bytext
How to order the builds.One of: number:desc,id:desc (Newest first), id (Oldest first). Default: number:desc,id:desc.
Page sizelimitnumber
How many to return on this page. Travis CI's default is 25.From 1 to 100.
Offsetoffsetnumber
Where the page starts: the next_offset of the page before. Leave empty for the first page.At least 0.

Outputs

buildslist
Builds
countnumber
How many are on this page
has_moretrue/false
Whether there is another page
next_offsetnumber
Offset to ask for to get the next page, or null on the last page
offsetnumber
Where this page starts
totalnumber
How many there are in all
Example output
{
  "builds": [
    {
      "branch": "main",
      "commit_message": "Bump dependencies",
      "commit_ref": "refs/heads/main",
      "commit_sha": "4f2a9c1e7b3d5a6f8e0c2b4d6a8f0e1c3b5d7a9f",
      "committed_at": "2026-10-20T09:13:40Z",
      "compare_url": "https://github.com/acme/api/compare/1a2b3c4d5e6f...4f2a9c1e7b3d",
      "created_by_login": "ada",
      "duration": 94,
      "event_type": "push",
      "finished_at": "2026-10-20T09:15:36Z",
      "id": 276451235,
      "is_finished": true,
      "job_ids": [
        627905412
      ],
      "number": "57",
      "previous_state": "failed",
      "priority": false,
      "private": false,
      "pull_request_number": null,
      "pull_request_title": null,
      "repository_id": 25113940,
      "repository_slug": "acme/api",
      "stages": [],
      "started_at": "2026-10-20T09:14:02Z",
      "state": "passed",
      "tag": null,
      "updated_at": "2026-10-20T09:15:36.512Z"
    }
  ],
  "count": 1,
  "has_more": true,
  "next_offset": 25,
  "offset": 0,
  "total": 57
}

List cron jobs

List a repository's cron jobs: the branch each one builds, how often, and when it runs next.

Inputs

RepositoryrepositorytextRequired
The repository. Pick one, or type its owner/repo slug or Travis CI id, or paste its Travis CI URL.

Outputs

countnumber
How many there are
cronslist
Cron jobs
Example output
{
  "count": 1,
  "crons": [
    {
      "active": true,
      "branch": "main",
      "created_at": "2026-10-20T09:00:00Z",
      "dont_run_if_recent_build_exists": true,
      "id": 61942,
      "interval": "weekly",
      "last_run": null,
      "next_run": "2026-10-27T09:00:00Z",
      "repository_id": 25113940,
      "repository_slug": "acme/api"
    }
  ]
}

List environment variables

List a repository's environment variables: name, id, branch, and the value of each public one. Travis CI never returns a private variable's value.

Inputs

RepositoryrepositorytextRequired
The repository. Pick one, or type its owner/repo slug or Travis CI id, or paste its Travis CI URL.

Outputs

countnumber
How many there are
env_varslist
Environment variables
Example output
{
  "count": 2,
  "env_vars": [
    {
      "branch": null,
      "id": "6f1c2d3e-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
      "name": "DEPLOY_REGION",
      "public": true,
      "value": "eu-west-1"
    },
    {
      "branch": "main",
      "id": "0a9b8c7d-6e5f-4a3b-9c1d-2e3f4a5b6c7d",
      "name": "DEPLOY_TOKEN",
      "public": false,
      "value": null
    }
  ]
}

List repositories

List the repositories you can see in Travis CI, active ones by default, with each one's id, slug, default branch and whether Travis CI builds it.

Inputs

Statusstatustext
Which repositories to list.One of: active (Active on Travis CI), inactive (Not active), all. Default: active.
Visibilityvisibilitytext
Public repositories, private ones, or both.One of: all (Public and private), public (Public only), private (Private only). Default: all.
Only starredstarredtrue/false
Only repositories you starred in Travis CI.Default: false.
Sort bysort_bytext
How to order the repositories.One of: name (Name, A to Z), name:desc (Name, Z to A), owner_name,name (Owner, then name), id:desc (Most recently added first). Default: name.
Page sizelimitnumber
How many to return on this page. Travis CI's default is 25.From 1 to 100.
Offsetoffsetnumber
Where the page starts: the next_offset of the page before. Leave empty for the first page.At least 0.

Outputs

countnumber
How many are on this page
has_moretrue/false
Whether there is another page
next_offsetnumber
Offset to ask for to get the next page, or null on the last page
offsetnumber
Where this page starts
repositorieslist
Repositories
totalnumber
How many there are in all
Example output
{
  "count": 1,
  "has_more": false,
  "next_offset": null,
  "offset": 0,
  "repositories": [
    {
      "active": true,
      "default_branch": "main",
      "description": "Acme's public API",
      "id": 25113940,
      "language": "Python",
      "name": "api",
      "owner_name": "acme",
      "private": false,
      "slug": "acme/api",
      "starred": false,
      "vcs_id": "512345678",
      "vcs_type": "GithubRepository",
      "web_url": "https://app.travis-ci.com/github/acme/api"
    }
  ],
  "total": 1
}

Trigger build

Ask Travis CI to build a branch, optionally a given commit, with a message and config overrides. Travis CI decides on the request moments later: Get request, with the request id this returns, shows the build or the reason there is none. Builds only run once a plan is selected in Travis CI. It accepts 10 such requests per repository an hour.

Inputs

RepositoryrepositorytextRequired
The repository. Pick one, or type its owner/repo slug or Travis CI id, or paste its Travis CI URL.
Branchbranchtext
The branch to build. Leave empty for the default branch.
Commitshatext
The commit to build. Leave empty for the branch's latest.
Messagemessagetext
Shown as the build's message in Travis CI.
Config overridesconfigobject
Settings to use for this build, one .travis.yml key per row, such as script with echo hello. A value written as JSON, such as a list, is sent as that JSON.
Combine with .travis.ymlmerge_modetext
How the config overrides combine with the repository's .travis.yml. Used only with config overrides.One of: deep_merge_append (Merge into .travis.yml, adding to its lists), deep_merge_prepend (Merge into .travis.yml, putting lists first), merge (Replace whole sections of .travis.yml), replace (Ignore .travis.yml and use only this config). Default: deep_merge_append.

Outputs

branchtext
Branch requested; empty means the default branch
merge_modetext
How the config was combined with .travis.yml
messagetext
Message sent with the request
remaining_requestsnumber
Builds this repository can still be sent through the API this hour
repository_idnumber
Travis CI repository id
repository_slugtext
Repository owner and name
request_idnumber
Request id, for Get request
shatext
Commit requested
Example output
{
  "branch": "main",
  "merge_mode": null,
  "message": "Nightly deploy check",
  "remaining_requests": 9,
  "repository_id": 25113940,
  "repository_slug": "acme/api",
  "request_id": 991204517,
  "sha": null
}

Update environment variable

Change an environment variable's value, name, branch or whether its value shows in build logs. Only what you fill in changes.

Inputs

RepositoryrepositorytextRequired
The repository. Pick one, or type its owner/repo slug or Travis CI id, or paste its Travis CI URL.
Environment variableenv_var_idtextRequired
The variable. Pick one, or paste its id from List environment variables.
New namenametext
Letters, digits and underscores. Leave empty to keep it.
New valuevaluetext
Kept exactly as typed. Leave empty to keep it.
Show value in build logspublictext
Whether the value shows in build logs.One of: unchanged (Leave as it is), public (Show the value in build logs), private (Hide the value). Default: unchanged.
Branchbranchtext
Move it to apply only to this branch. Leave empty to keep it.

Outputs

branchtext
The only branch it applies to, or null for all
idtext
Variable id, for Update and Delete environment variable
nametext
Variable name
publictrue/false
Whether its value shows in build logs
valuetext
Its value, for a public variable only. Travis CI never returns a private one.
Example output
{
  "branch": null,
  "id": "6f1c2d3e-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
  "name": "DEPLOY_REGION",
  "public": true,
  "value": "eu-central-1"
}

On this page