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 
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 |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": [] 
}