Processes - Import Process Template

Reference

Service:: Work Item Tracking Process Template

API Version:: 5.0-preview.1

Imports a process from zip file.

POST https://dev.azure.com/{organization}/_apis/work/processadmin/processes/import?api-version=5.0-preview.1

With optional parameters:

POST https://dev.azure.com/{organization}/_apis/work/processadmin/processes/import?ignoreWarnings={ignoreWarnings}&api-version=5.0-preview.1

URI Parameters

Name	In	Required	Type	Description
organization	path	True	string	The name of the Azure DevOps organization.
api-version	query	True	string	Version of the API to use. This should be set to '5.0-preview.1' to use this version of the api.
ignoreWarnings	query		boolean	Default value is false

Request Body

Media Types: "application/octet-stream"

Name	Type	Description
body	string	Stream to upload

Responses

Name	Type	Description
200 OK	ProcessImportResult	successful operation

Security

accessToken

Personal access token. Use any value for the user name and the token as the password.

Type: basic

Examples

Sample Request

HTTP

POST https://dev.azure.com/fabrikam/_apis/work/processadmin/processes/import?api-version=5.0-preview.1

Sample Response

Status code:: 202

persistent-Auth: true
lfs-Authenticate: NTLM

Response Body

{
  "id": "adcc42ab-9882-485e-a3ed-7678f01f66bd",
  "promoteJobId": "00000000-0000-0000-0000-000000000000",
  "helpUrl": null,
  "validationResults": [],
  "isNew": false
}

Definitions

Name	Description
ProcessImportResult	Describes the result of a Process Import request.
ValidationIssue
ValidationIssueType

ProcessImportResult

Describes the result of a Process Import request.

Name	Type	Description
helpUrl	string	Help URL.
id	string	ID of the import operation.
isNew	boolean	Whether this imported process is new.
promoteJobId	string	The promote job identifier.
validationResults	ValidationIssue[]	The list of validation results.

ValidationIssue

Name	Type	Description
description	string
file	string
helpLink	string
issueType	ValidationIssueType
line	integer

ValidationIssueType

Name	Type	Description
error	string
warning	string