Parameters - 7.0.0

	Parameter	Short	Description
1	acceptType		Content type to accept for renderRequest if different than type.
2	action	a	Requested operation to perform. Valid actions are listed at the end.
3	after		Used in orderRepository to name the repository after which the repository will be positioned. Similarly for moveTask where it represent the name or id of the task. Similarly for moveStage where it represent the name of the stage.
4	afterSql		SQL to run after a successful action. Limited to specific actions at this time.
5	agent		Agent name.
6	append		Append to existing varaibles on updateVariables. For some actions using the file parameter, append will append output to the existing file.
7	artifact		Build artifact name. May be extended by a path name for locating files within an artifact representing a dirctory.
8	assignment		Key used to identify a project, plan, job, deployment proejct, or environment to be assigned to a specific agent. This makes the agent dedicated to only perform builds for all assignments. Examples: XXX, XXX-DEF, XXX-DEF-JOB1, Deployment for XXX-DEF, Deployment for XXX-DEF:QA, 77857004-77955436
9	automatic		Indicate that a stage be run automatically.
10	before		Before task name or id.
11	branch		Branch name.
12	build		Build key. Normally used to refer to a specific build (3 or 4 part name). However, it was also an older terminology for a plan and some action continue to accept the older terminology. Example: XXX-DEF or XXX-DEF-1
13	childPlans		Comma separated list of plan keys that represent child plan dependencies.
14	cleanAfter		Clean working directory after each job completes. Use on setJobOptions.
15	clearFileBeforeAppend		For run actions, this option will automatically clear an existing file on the first append requested.
16	columns		Column selection and ordering when action generates CSV output. A comma separated list of column numbers (1-based) or column names (case insensitive). Only columns provided by the selected outputFormat are available for selection. Invalid columns will be ignored.
17	comment		Comment text.
18	common		Common parameter string added to all run actions.
19	connectionTimeout		Allow overriding environment settings for connect and read timeouts on URL connections. In milliseconds, 0 means infinite.
20	continue		Continue processing even after errors are encountered for run actions. Also used for some action to ignore certain errors like not found errors on remove actions.
21	cookies		Name of file to restore and persist cookies across invocations of CLI actions. Can be used to provide Data Center session affinity for actions using REST APIs.
22	copyPattern		Copy pattern for an artifact definition.
23	database		Database name is required for SQL actions.
24	dateFormat		Format string for dates in Java SimpleDateFormat. Default for output is client date format. Default for date parsing is lenient starting with client date format and then some other standard formats based on JSON date format.
25	dateFormat2		Alternate format string for dates in Java SimpleDateFormat. Use specific (may be ignored), but normally used for date only fields to avoid longer dateFormat based output. Some uses default to yyyy-MM-dd.
26	dbCreateTable		Database table needs to be created before adding rows.
27	dbJar		By default, lib/jdbc is used to automatically load database drivers. Otherwise you can specify a specific file or url reference for the database driver jar. Example /jdbcDrivers/postgresql-9.3-1102.jdbc41.jar or https://jdbc.postgresql.org/download/postgresql-9.3-1102.jdbc41.jar
28	dbPassword		Database user password. Defaults to password.
29	dbTable		Database table name when creating or updating a database from list output.
30	dbTableKeys		Comma separated list of column names used to access existing rows for update. Normally this defines a primary key set for the table.
31	dbUser		Database user name. Defaults to user.
32	debug		Requests detail debug output. Optional for all actions.
33	deploymentProject		Deployment project name or id.
34	description		Description for entity.
35	disable		Disable an entity for those entities like plans, stages, jobs, and tasks.
36	driver		JDBC driver class or predefined value: postgresql, mysql, mssql, oracle, or db2400. Required for SQL actions.
37	enable		Enable an entity when updating.
38	encoding		Character encoding (character set) for text based file content - must be an encoding supported by your JAVA platform.
39	environment		Deployment environment name or id.
40	event		Event alias or key. Add-ons provide events identified by key. Example key: com.atlassian.bamboo.plugin.system.notifications:chainCompleted.failedChains
41	excludeDisabled		Filter out entries that are disabled.
42	excludeEnabled		Filter out entries that are enabled.
43	expand		Expanded request information to obtain more detailed data on request.
44	favorite		Subset to favorites. Same as favourite.
45	favourite		Subset to favourites. Same as favorite.
46	field		Use to set construct specific fields or variables using field=value syntax. The first equal sign (=) delineates the field name from it's value. Multiple field parameters can be provided. This provides a more convenient and expandable way to set fields as an alternative to the fields and numbered field parameters. Values are trimmed unless single quoted and single quoted strings will have single quotes removed.
47	field1		Construct specific field or variable name. Value is specified by the value1 parameter.
48	field2		Construct specific field or variable name. Value is specified by the value2 parameter.
49	field3		Construct specific field or variable name. Value is specified by the value3 parameter.
50	field4		Construct specific field or variable name. Value is specified by the value4 parameter.
51	field5		Construct specific field or variable name. Value is specified by the value5 parameter.
52	field6		Construct specific field or variable name. Value is specified by the value6 parameter.
53	field7		Construct specific field or variable name. Value is specified by the value7 parameter.
54	field8		Construct specific field or variable name. Value is specified by the value8 parameter.
55	fields		Use to specify task or repository specific fields or variables and their values. A comma separated list of key:value pairs. Single quote the key:value pair if it contains a comma (,) or line breaks.
56	file	f	Path to file based content or result output. Use - for standard input.
57	final		Make a final task.
58	findReplace		Find and replace text. Comma separated list of colon separated pairs. Single quote values containing a delimiter. Embedded quotes must be escaped.
59	findReplaceRegex		Find and replace text with a regular expression. Comma separated list of colon separated pairs. Single quote values containing a delimiter. Embedded quotes must be doubled.
60	help		Prints this help message.
61	host		Database host server for SQL actions. Not used if url is provided. Defaults to localhost if not provided.
62	id		Stage or task id.
63	ipRestriction		Comma separated list of IP addresses to restrict ability to remotely trigger builds.
64	issues		Comma separated list of JIRA issue keys.
65	job		Job key. Example: JOB1
66	labels		Comma or blank separated list of labels.
67	limit		Maximum number of entries to return.
68	list		Comma separated list of entries to populate the entry replacement variable on runFromList. Single quote values containing a delimiter. Embedded quotes must be doubled.
69	list2		Comma separated list of entries to populate the entry2 replacement variable on runFromList. Single quote values containing a delimiter. Embedded quotes must be doubled.
70	location		Working directory relative path to a source location for an artifact definition or a destination location for an artifact dependency.
71	manual		Indicate that a stage be run manually.
72	name		Name of entity, like plan name.
73	number		Build number. Defaults to latest.
74	options		Comma separated list of support, experimental, or other client or action specific options.
75	outputFormat		Specify output format for an action.
76	password	p	User password for remote access. This is a required parameter for most actions.
77	plan		Plan key containing the project key. Preferred way to reference a plan instead of the older build terminology. Example: XXX-DEF
78	port		Database host port for SQL actions. Optional, defaults to database default. Not used if url is provided.
79	project		Project key. Example: XXX
80	projectName		Project name.
81	propertyFile		Property file with database parameters, field mappings, or client specific information.
82	quiet		Limit some output messages. Optional for all actions.
83	recipient		Recipient value for add notifications. Many recipient types need a primary recipient value. This parameter can be used instead of setting a recipient type specific field and value.
84	recipientType		Recipient type alias or key. Add-ons provide recipient types identified by key. Example key: com.atlassian.bamboo.plugins.bamboo-hipchat:recipient.hipchat
85	reference		Reference to a replacement key value used to remember an action specific value like issue key or similar so it can be referenced later.Each action that allows this parameter will specify what value is being set for the reference replacement key.
86	regex		Regular expression for list filtering and similar. Also for pattern match labelling.
87	replace		Replace existing entity on add, create, or similar actions.
88	repository		Name of a repository. In some cases, a comma separated list of repository names.
89	repositoryKey		Repository key that uniquely identifies the repository type. Example: com.atlassian.bamboo.plugins.atlassian-bamboo-plugin-mercurial:hg
90	request		URL fragment for a request.
91	requestParameters		URL request parameters or post data.
92	requestType		Type of a render request like GET or POST
93	requirement		Plan requirement key, either a custom key or a system capability key like: system.builder.ant.Ant.
94	revision		Revision id or tag.
95	schedule		Cron, daily time, or periodic schedule. A cron schedule must be valid cron expresssions and defaults to 0 0 0 ? * *. A daily time is a 24 hour format (HH:mm) value. A periodic schedule is a numeric value in seconds and defaults to 180.
96	server	s	Server URL. Normally the same URL used when using a browser to access the server. This is a required parameter for most actions.
97	shared		For an artifact definition, makes the artifact available for other builds.
98	simulate		Simulate running actions. Log the action that would be taken.
99	special		Ordered list of alternate characters for comma ( , ), colon ( : ), at ( @ ), quote ( ' ), and double quote ( " ) characters used for specialized processing of some specific parameters.
100	sql		SQL select statement used to generate a run script.
101	stage		Stage name.
102	successfulPlans		Comma separated list of keys that represent plans that must be successful before a build is triggered.
103	task		Task id, name, or description. Task ids are unique, but names and descriptions are not. Name and description lookup is done by finding the first match in the ordered task list.
104	taskKey		Task key. Example: com.atlassian.bamboo.plugins.scripttask:task.builder.script.An alias can also be used to make it easier and less error prone. See addTask for the list.
105	timeout		Wait timeout in seconds. Use -1 to wait forever.
106	toPlan		Plan key to be created. Example: XXX-DEF
107	toProject		Project key to clone to.
108	triggeringEnvironment		Deployment environment name or id.
109	type		Requirement match type. Values: exist (default), equal, match. Also, content type for renderRequest and trigger type for addTrigger.
110	url		Action specific setting. Example: Database access url for SQL actions. Optional when host is provided.
111	user	u	User name for remote access.
112	value		Requirement match value.
113	value1		Value corresponding to the field1 parameter name.
114	value2		Value corresponding to the field2 parameter name.
115	value3		Value corresponding to the field3 parameter name.
116	value4		Value corresponding to the field4 parameter name.
117	value5		Value corresponding to the field5 parameter name.
118	value6		Value corresponding to the field6 parameter name.
119	value7		Value corresponding to the field7 parameter name.
120	value8		Value corresponding to the field8 parameter name.
121	verbose		Requests verbose output to help with problem determination. Optional for all actions.
122	version		Version name for deployment.
123	wait		Wait for action to complete.