Add Issue

Adds new issue.

Role

Administrator
Normal User
Reporter
Guest Reporter

Method

POST

URL

/api/v2/issues

Form parameters

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

Parameter Name	Type	Description
projectId (Required)	Number	Project ID
summary (Required)	String	Summary
parentIssueId	Number	Parent Issue ID
description	String	Description
startDate	String	Start Date (yyyy-MM-dd)
dueDate	String	Due Date (yyyy-MM-dd)
estimatedHours	Number	Estimated Hours
actualHours	Number	Actual Hours
issueTypeId (Required)	Number	Issue Type ID
categoryId[] (Multiple)	Number	Category ID
versionId[] (Multiple)	Number	Version ID
milestoneId[] (Multiple)	Number	Milestone ID
priorityId (Required)	Number	Priority ID
assigneeId	Number	Assignee ID
notifiedUserId[] (Multiple)	Number	Notified User ID
attachmentId[] (Multiple)	Number	Attachment file ID(Post Attachment File returns)

Custom Fields

Parameter Name	Type	Description
customField_{id}	-	value
customField_{id}_otherValue	-	Other text of List

Response example

Status Line / Response Header

HTTP/1.1 201 CREATED
Content-Type:application/json;charset=utf-8
Location:https://xx.backlogtool.com/view/BLG-5742

Response Body

{
    "id": 1,
    "projectId": 1,
    "issueKey": "BLG-1",
    "keyId": 1,
    "issueType": {
        "id": 2,
        "projectId" :1,
        "name": "Task",
        "color": "#7ea800",
        "displayOrder": 0
    },
    "summary": "first issue",
    "description": "",
    "resolution": null,
    "priority": {
        "id": 3,
        "name": "Normal"
    },
    "status": {
        "id": 1,
        "projectId": 1,
        "name": "Open",
        "color": "#ed8077",
        "displayOrder": 1000
    },
    "assignee": {
        "id": 2,
        "userId": "eguchi",
        "name": "eguchi",
        "roleType" :2,
        "lang": null,
        "nulabAccount": {
            "nulabId": "tSaVeJfRxLURSAkgfbNAfCbM7PqddYLJ3nG3BELjx6eSTbu8LD",
            "name": "eguchi",
            "uniqueId": "eguchi"
        },
        "mailAddress": "eguchi@nulab.example",
        "lastLoginTime": "2022-09-01T06:35:39Z"
    },
    "category": [],
    "versions": [],
    "milestone": [
        {
            "id": 30,
            "projectId": 1,
            "name": "wait for release",
            "description": "",
            "startDate": null,
            "releaseDueDate": null,
            "archived": false,
            "displayOrder": 0
        }
    ],
    "startDate": null,
    "dueDate": null,
    "estimatedHours": null,
    "actualHours": null,
    "parentIssueId": null,
    "createdUser": {
        "id": 1,
        "userId": "admin",
        "name": "admin",
        "roleType": 1,
        "lang": "ja",
        "nulabAccount": {
            "nulabId": "Prm9ZD9DQD5snNWcSYSwZiQoA9WFBUEa2ySznrSnSQRhdC2X8G",
            "name": "admin",
            "uniqueId": "admin"
        },
        "mailAddress": "eguchi@nulab.example",
        "lastLoginTime": "2022-09-01T06:35:39Z"
    },
    "created": "2012-07-23T06:10:15Z",
    "updatedUser": {
        "id": 1,
        "userId": "admin",
        "name": "admin",
        "roleType": 1,
        "lang": "ja",
        "nulabAccount": {
            "nulabId": "Prm9ZD9DQD5snNWcSYSwZiQoA9WFBUEa2ySznrSnSQRhdC2X8G",
            "name": "admin",
            "uniqueId": "admin"
        },
        "mailAddress": "eguchi@nulab.example",
        "lastLoginTime": "2022-09-01T06:35:39Z"
    },
    "updated": "2012-07-23T06:10:15Z",
    "customFields": [],
    "attachments": [
        {
            "id": 1,
            "name": "IMGP0088.JPG",
            "size": 85079
        },
        // ...
    ],
    "sharedFiles": [],
    "stars": []
}