Skip to main content
Jenkins logo

Jenkins

Lets an agent drive a Jenkins controller through its remote access API - list and configure jobs, trigger and watch builds, manage the queue and inspect nodes, views and plugins.

What it can do

MethodWhat it does
jenkins_who_am_iGet the authenticated Jenkins user; use to verify credentials.
jenkins_get_crumbGet a CSRF crumb (the write actions fetch it automatically).
jenkins_get_system_infoGet controller top-level info (mode, executors, jobs, views).
jenkins_list_jobsList jobs, optionally scoped to a folder.
jenkins_get_jobGet one job's metadata, builds and health.
jenkins_get_job_configGet a job's raw config.xml.
jenkins_create_jobCreate a job from config.xml. WRITE - confirm first.
jenkins_copy_jobCopy an existing job to a new name. WRITE - confirm first.
jenkins_update_job_configReplace a job's config.xml. WRITE - confirm first.
jenkins_delete_jobDelete a job. WRITE - confirm first.
jenkins_enable_jobEnable a job. WRITE - confirm first.
jenkins_disable_jobDisable a job. WRITE - confirm first.
jenkins_build_jobTrigger a non-parameterized build. WRITE - confirm first.
jenkins_build_with_parametersTrigger a parameterized build. WRITE - confirm first.
jenkins_get_buildGet build info (number or selector like lastBuild).
jenkins_get_build_consoleGet a build's plain-text console log.
jenkins_stop_buildStop a running build. WRITE - confirm first.
jenkins_get_queueList the build queue.
jenkins_get_queue_itemGet one queue item.
jenkins_cancel_queue_itemCancel a queued item. WRITE - confirm first.
jenkins_list_computersList nodes (build agents) and their online state.
jenkins_get_computerGet one node by name.
jenkins_list_viewsList dashboard views.
jenkins_get_viewGet one view and its jobs.
jenkins_list_pluginsList installed plugins and versions.
jenkins_restartRestart the controller (safe or immediate). WRITE - confirm first.
jenkins_quiet_downBlock or resume new builds. WRITE - confirm first.

How to get credentials

The agent authenticates with HTTP Basic auth using your Jenkins username and a personal API token (not your password).

  1. Open the Jenkins remote access API docs for reference.
  2. In Jenkins, click your name (top right) and choose Configure.
  3. Under API Token, click Add new Token, give it a name (e.g. FlyMyAI Agent) and Generate.
  4. Copy the generated token - it is shown only once.
  5. Note your Jenkins base URL (e.g. https://ci.example.com) and your login username.

Fields to fill in FlyMyAI

FlyMyAI fieldWhere it comes from
JENKINS_BASE_URLRoot URL of your Jenkins controller, e.g. https://ci.example.com
JENKINS_USERNAMEYour Jenkins login username
JENKINS_API_KEYUser → Configure → API Token → Add new Token

Troubleshooting

  • 403 No valid crumb - CSRF protection is on; the write actions fetch a crumb automatically, so confirm the token user has permission to read crumbIssuer.
  • 401 / 403 - wrong username or token, or the user lacks the job/build permission. Use an API token, never your account password.
  • 404 - check the job path; nested jobs use folder paths like team/backend/deploy.
We love our partners - FlyMy.AI builds with the best. Thanks, Jenkins!