Create a job in Jenkins (or folder) using the HTTP API

CreateJob.sh

# check if job exists
curl -XGET 'http://jenkins/checkJobName?value=yourJobFolderName' --user user.name:YourAPIToken

# with folder plugin
curl -s -XPOST 'http://jenkins/job/FolderName/createItem?name=yourJobName' --data-binary @config.xml -H "Content-Type:text/xml" --user user.name:YourAPIToken

# without folder plugin
curl -s -XPOST 'http://jenkins/createItem?name=yourJobName' --data-binary @config.xml -H "Content-Type:text/xml" --user user.name:YourAPIToken

# create folder
curl -XPOST 'http://jenkins/createItem?name=FolderName&mode=com.cloudbees.hudson.plugins.folder.Folder&from=&json=%7B%22name%22%3A%22FolderName%22%2C%22mode%22%3A%22com.cloudbees.hudson.plugins.folder.Folder%22%2C%22from%22%3A%22%22%2C%22Submit%22%3A%22OK%22%7D&Submit=OK' --user user.name:YourAPIToken -H "Content-Type:application/x-www-form-urlencoded"


# see http://jenkins/api/

this is a life saver thanks

:)

What does mode stand for in the last API?

Another way to check whether job exists:
curl -XGET 'http://jenkins/job/yourJobName/api/json' --user user.name:YourAPIToken
This returns either 200 or 404 depending on whether the job already exists.

HI
Can i send string parameters and there value ....while creating job with curl. I need to create a job which is parameterized through the api.

thank you, helped a lot

very good tks

Thanks. I will try it on Monday at desk :o)

🎉

Hi, do you have jenkins buildjob.sh? :)

Hi @stuart-warren, for the create folder request, from parameter is needed?
According to https://github.com/jenkinsci/jenkins/blob/master/core/src/main/java/hudson/model/ItemGroupMixIn.java
from parameter is only used when the mode parameter equals "copy".

Regards!

Hi
Any API we can add the user to the Jenkins with read and build access for a jenkins job ?

Thanks
Vamsi

Hi @vamsikrishnakoni
You can take a look at RoleBasedAuthorizationStrategy.java. There are examples with cURL for managing roles.

I'm not sure whether you can add the user and assign a role in once. Hope it helps you 😄

How do you "Move" a job which is not currently in a folder to a newly created folder? Using whatever API possible?

Is it possible to send instead xml content, only json ? How?

Thanks! It's really to save my time!

thanks man!

Thank you for the commands. I'm just wondering if there is an instruction on how to do the same thing with the config file in JSON format if that is possible?

Also, does anybody know about the document or tutorial on how to create config.xml for a new job?

Thank you in advance.

Thanks for the command, I am wondering if there is an option to overwrite an existing job.

Thanks, this worked great!

00:19:39 % Total % Received % Xferd Average Speed Time Time Time Current
00:19:39 Dload Upload Total Spent Left Speed
00:19:39
0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0
100 550 100 550 0 0 7142 0 --:--:-- --:--:-- --:--:-- 7142
00:19:39
00:19:39
00:19:39
00:19:39 <title>Error 403 No valid crumb was included in the request</title>
00:19:39
00:19:39

HTTP ERROR 403 No valid crumb was included in the request

00:19:39
00:19:39
00:19:39
00:19:39
00:19:39
00:19:39

URI:	/createItem
STATUS:	403
MESSAGE:	No valid crumb was included in the request
SERVLET:	Stapler

00:19:39

---

Powered by Jetty:// 10.0.16

---

00:19:39
00:19:39
00:19:39