Contents

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 NameTypeDescription
projectIdOrKeyStringProject ID or Project Key
idNumberCustom field ID

Form parameters

Content-Type:application/x-www-form-urlencoded
Parameter NameTypeDescription
nameStringList 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
        },
        // ...
    ]
}