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 
    "typeId": 5 
    "name": "language" 
    "description": "" 
    "required": false 
    "applicableIssueTypes": [ ] 
    "allowAddItem": true 
    "items": [ 
        { 
            "id": 1 
            "name": "java" 
            "displayOrder": 0 
        }, 
        ... 
    ] 
}