Fields - Add

Service:

Work Item Tracking Process

API Version:

6.0-preview.2

Adds a field to a work item type.

POST https://dev.azure.com/{organization}/_apis/work/processes/{processId}/workItemTypes/{witRefName}/fields?api-version=6.0-preview.2

URI Parameters

Name	In	Required	Type	Description
organization	path	True	string	The name of the Azure DevOps organization.
processId	path	True	string (uuid)	The ID of the process.
witRefName	path	True	string	The reference name of the work item type.
api-version	query	True	string	Version of the API to use. This should be set to '6.0-preview.2' to use this version of the api.

Request Body

Name	Type	Description
allowGroups	boolean	Allow setting field value to a group identity. Only applies to identity fields.
allowedValues	string[]	The list of field allowed values.
defaultValue	object	The default value of the field.
readOnly	boolean	If true the field cannot be edited.
referenceName	string	Reference name of the field.
required	boolean	If true the field cannot be empty.

Responses

Name	Type	Description
200 OK	ProcessWorkItemTypeField	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.work_write	Grants the ability to read, create, and update work items and queries, update board metadata, read area and iterations paths other work item tracking related metadata, execute queries, and to receive notifications about work item events via service hooks.

Examples

Adds a field to a work item type

Sample request

HTTP

POST https://dev.azure.com/{organization}/_apis/work/processes/{processId}/workItemTypes/{witRefName}/fields?api-version=6.0-preview.2

{
  "referenceName": "Custom.Fields.Colors",
  "defaultValue": "",
  "allowGroups": false
}

Sample response

Status code:

200

{
  "referenceName": "Custom.Fields.Colors",
  "name": "Colors",
  "type": "string",
  "description": "My new field",
  "url": "https://dev.azure.com/fabrikamm0652/_apis/work/processes/4bab314e-358e-4bf3-9508-806ba6ac0c30/behaviors",
  "customization": "custom"
}

Definitions

Name	Description
AddProcessWorkItemTypeFieldRequest	Class that describes a request to add a field in a work item type.
CustomizationType	Indicates the type of customization on this work item. System behaviors are inherited from parent process but not modified. Inherited behaviors are modified modified behaviors that were inherited from parent process. Custom behaviors are behaviors created by user in current process.
FieldType
ProcessWorkItemTypeField	Class that describes a field in a work item type and its properties.

AddProcessWorkItemTypeFieldRequest

Object

Class that describes a request to add a field in a work item type.

Name	Type	Description
allowGroups	boolean	Allow setting field value to a group identity. Only applies to identity fields.
allowedValues	string[]	The list of field allowed values.
defaultValue	object	The default value of the field.
readOnly	boolean	If true the field cannot be edited.
referenceName	string	Reference name of the field.
required	boolean	If true the field cannot be empty.

CustomizationType

Enumeration

Indicates the type of customization on this work item. System behaviors are inherited from parent process but not modified. Inherited behaviors are modified modified behaviors that were inherited from parent process. Custom behaviors are behaviors created by user in current process.

Value	Description
system	Customization-type is System if is system generated workitemtype.
inherited	Customization-type is Inherited if the existing workitemtype of inherited process is customized.
custom	Customization-type is Custom if the newly created workitemtype is customized.

FieldType

Enumeration

Value	Description
string	String field type.
integer	Integer field type.
dateTime	DateTime field type.
plainText	Plain text field type.
html	HTML (Multiline) field type.
treePath	Treepath field type.
history	History field type.
double	Double field type.
guid	Guid field type.
boolean	Boolean field type.
identity	Identity field type.
picklistInteger	Integer picklist field type.
picklistString	String picklist field type.
picklistDouble	Double picklist field type.

ProcessWorkItemTypeField

Object

Class that describes a field in a work item type and its properties.

Name	Type	Description
allowGroups	boolean	Allow setting field value to a group identity. Only applies to identity fields.
allowedValues	object[]	The list of field allowed values.
customization	CustomizationType	Indicates the type of customization on this work item.
defaultValue	object	The default value of the field.
description	string	Description of the field.
name	string	Name of the field.
readOnly	boolean	If true the field cannot be edited.
referenceName	string	Reference name of the field.
required	boolean	If true the field cannot be empty.
type	FieldType	Type of the field.
url	string	Resource URL of the field.