Add Issue

Adds new issue.

Role

Administrator
Normal User
Reporter
Guest Reporter

Method

POST

URL

/api/v2/issues

Form Parameters

Request Header

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
dueDate String Due Date
estimatedHours Number Estimated Hours
actualHours Number Actual Hours
issueTypeId (Required) Number Issue Type ID
categoryId[] Number Category ID
versionId[] Number Version ID
milestoneId[] Number Milestone ID
priorityId (Required) Number Priority ID
assigneeId Number Assignee ID
notifiedUserId[] Number Notified User ID
attachmentId[] 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": "",
    "resolutions": null,
    "priority": {
        "id": 3,
        "name": "Normal"
    },
    "status": {
        "id": 1,
        "name": "Open"
    },
    "assignee": {
        "id": 2,
        "userId": "eguchi",
        "name": "eguchi",
        "roleType" :2,
        "lang": null,
        "mailAddress": "eguchi@nulab.example"
    },
    "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",
        "mailAddress": "eguchi@nulab.example"
    },
    "created": "2012-07-23T06:10:15Z",
    "updatedUser": {
        "id": 1,
        "userId": "admin",
        "name": "admin",
        "roleType": 1,
        "lang": "ja",
        "mailAddress": "eguchi@nulab.example"
    },
    "updated": "2012-07-23T06:10:15Z",
    "customFields": [],
    "attachments": [
        {
            "id": 1,
            "name": "IMGP0088.JPG",
            "size": 85079
        },
        ...
    ],
    "sharedFiles": [],
    "stars": []
}