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

Request Header

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
        },
        ...
    ]
}