Add List Item for List Type Custom Field

Adds new list item for list type custom field. Only administrator can call this API if the option “Add items in adding or editing issues” is disabled in settings. Calling API fails if specified custom field’s type is not a list.

Role

Administrator 
Normal User

Method

POST

URL

/api/v2/projects/:projectIdOrKey/customFields/:id/items

URL parameters

Parameter Name	Type	Description
projectIdOrKey	String	Project ID or Project Key
id	Number	Custom field ID

Form parameters

Content-Type:application/x-www-form-urlencoded

Parameter Name	Type	Description
name	String	List item name

Response example

Status Line / Response Header

HTTP/1.1 200 OK 
Content-Type:application/json;charset=utf-8

Response Body

{ 
    "id": 8,
    "projectId": 5,
    "typeId": 5,
    "name": "language",
    "description": "",
    "required": false,
    "applicableIssueTypes": [ ],
    "allowAddItem": true,
    "items": [ 
        { 
            "id": 1,
            "name": "java",
            "displayOrder": 0 
        }, 
        ... 
    ] 
}