Pipelines - Create

Service:

Pipelines

API Version:

7.1

Create a pipeline.

POST https://dev.azure.com/{organization}/{project}/_apis/pipelines?api-version=7.1

URI Parameters

Name	In	Required	Type	Description
organization	path	True	string	The name of the Azure DevOps organization.
project	path	True	string	Project ID or project name
api-version	query	True	string	Version of the API to use. This should be set to '7.1' to use this version of the api.

Request Body

Name	Type	Description
configuration	CreatePipelineConfigurationParameters	Configuration parameters of the pipeline.
folder	string	Folder of the pipeline.
name	string	Name of the pipeline.

Responses

Name	Type	Description
200 OK	Pipeline	successful operation

Security

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Name	Description
vso.build_execute	Grants the ability to access build artifacts, including build results, definitions, and requests, and the ability to queue a build, update build properties, and the ability to receive notifications about build events via service hooks.

Definitions

Name	Description
ConfigurationType	Type of configuration.
CreatePipelineConfigurationParameters	Configuration parameters of the pipeline.
CreatePipelineParameters	Parameters to create a pipeline.
Pipeline	Definition of a pipeline.
PipelineConfiguration
ReferenceLinks	The class to represent a collection of REST reference links.

ConfigurationType

Type of configuration.

Name	Type	Description
designerHyphenJson	string	Designer-JSON.
designerJson	string	Designer JSON.
justInTime	string	Just-in-time.
unknown	string	Unknown type.
yaml	string	YAML.

CreatePipelineConfigurationParameters

Configuration parameters of the pipeline.

Name	Type	Description
type	ConfigurationType	Type of configuration.

CreatePipelineParameters

Parameters to create a pipeline.

Name	Type	Description
configuration	CreatePipelineConfigurationParameters	Configuration parameters of the pipeline.
folder	string	Folder of the pipeline.
name	string	Name of the pipeline.

Pipeline

Definition of a pipeline.

Name	Type	Description
_links	ReferenceLinks	The class to represent a collection of REST reference links.
configuration	PipelineConfiguration
folder	string	Pipeline folder
id	integer	Pipeline ID
name	string	Pipeline name
revision	integer	Revision number
url	string	URL of the pipeline

PipelineConfiguration

Name	Type	Description
type	ConfigurationType

ReferenceLinks

The class to represent a collection of REST reference links.

Name	Type	Description
links	object	The readonly view of the links. Because Reference links are readonly, we only want to expose them as read only.