Issue Tracking Tools | Bugs API : Zoho Projects

Bugs API

Scope: ZohoProjects.bugs.{Operation}

Operations: READ, CREATE, UPDATE, DELETE, ALL

Use the ALL operation to gain the scope for all the other operations like READ, CREATE, UPDATE, and DELETE at once.

All Bugs
GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/

Bug Details
GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/

Create a Bug
POST /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/

Update a Bug
POST /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/

Delete a Bug
DELETE /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/

Add Comment
POST /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/comments/

Get Comment
GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/comments/

Get Comments for Mutiple Bugs
GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/comments/

Delete Comment
DELETE /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/comments/[COMMENTID]

Get Bug Timer
GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/timer

Get Bug Custom Views
GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/customviews/

Get Bug Attachments
GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/attachments/

Get Bug Resolution
GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/resolution/

Add Bug Follower
POST /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/bugfollowers/

Get Bug Followers
GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/bugfollowers/

Delete Bug Follower
DELETE /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/bugfollowers/

Bugs Default Fields
GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/defaultfields/

Bugs Custom Fields
GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/customfields/

Bugs Activities
GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/activities/

Get Renamed Value
GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/renamedfields/

Get My Bugs
GET /restapi/portal/[PORTALID]/mybugs/

Get Associated Tasks
GET /api/v3/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/tasks

Associate Tasks
POST /api/v3/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/tasks

Dissociate Tasks
DELETE /api/v3/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/task/[TASKID]

All Bugs

Gets all the bugs in the given project.

GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/

Scope: ZohoProjects.bugs.READ

Request Parameters

index	int	Start index
range	int	Number of records (bugs)
statustype	string	Accepted values: open/closed
cview_id	long	Custom View ID
sort_column	string	Accepted values: created_time/last_modified_time
sort_order	string	Accpeted Value: ascending/descending
status	JSONArray	Status IDs as comma separated array
severity	JSONArray	Severity IDs as comma separated array
classification	JSONArray	Classification IDs as comma separated array
module	JSONArray	Module IDs as comma separated array
milestone	JSONArray	Milestons IDs as comma separated array
flag	string	Accepted values: Internal/External
assignee/assignee_zpuid	JSONArray	Specify ZUID of the assignee/Specify ZPUID of the assignee
escalation	JSONArray	Escalation IDs as comma separated array
reporter	JSONArray	Reporter IDs as comma separated array
affected	JSONArray	Affected milestone IDs as comma separated array

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8

{
    "bugs": [{
        "module": {
            "id": 170876000000494013,
            "name": "ERP Phase I"
        },
        "created_time_long": 1400012857000,
        "customfields": [{
            "label_name": "SNo",
            "value": "81",
            "column_name": "LONG1"
        }, {
            "label_name": "Sub Module",
            "value": "Finance",
            "column_name": "CHAR3"
        }, {
            "label_name": "Browser",
            "value": "Chrome",
            "column_name": "CHAR2"
        }, {
            "label_name": "Product",
            "value": "Code Manager",
            "column_name": "CHAR1"
        }],
        "status": {
            "id": 170876000000065048,
            "type": "InProgress"
        },
        "reproducible": {
            "id": 170876000000133005,
            "type": "Always"
        },
        "link": {
            "self": {
                "url": "https://projects.zoho.com/restapi/portal/2063927/projects/
                        170876000000147021/bugs/170876000001834047/"
            },
            "timesheet": {
                "url": "https://projects.zoho.com/restapi/portal/2063927/projects/
                        170876000000147021/bugs/170876000001834047/logs/"
            }
        },
        "severity": {
            "id": 170876000000065005,
            "type": "Major"
        },
        "reported_person": "Patricia Boyle",
        "id": 170876000001834047,
        "title": "Tilt causes crash",
        "flag": "Internal",
        "assignee_name": "Not Assigned",
        "reporter_id": "2060758",
        "classification": {
            "id": 170876000000133041,
            "type": "Feature(New)"
        },
        "created_time_format": "05-13-2014 05:57 PM",
        "closed": false,
        "created_time": "05-13-2014",
        "key": 541
    }]
}

Bug Details

Gets the details of the bug.

GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/

Scope: ZohoProjects.bugs.READ

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8

{
    "bugs": [{
        "module": {
            "id": 170876000000494013,
            "name": "ERP Phase I"
        },
        "created_time_long": 1400012857000,
        "customfields": [{
            "label_name": "SNo",
            "value": "81",
            "column_name": "LONG1"
        }, {
            "label_name": "Sub Module",
            "value": "Finance",
            "column_name": "CHAR3"
        }, {
            "label_name": "Browser",
            "value": "Chrome",
            "column_name": "CHAR2"
        }, {
            "label_name": "Product",
            "value": "Code Manager",
            "column_name": "CHAR1"
        }],
        "status": {
            "id": 170876000000065048,
            "type": "InProgress"
        },
        "reproducible": {
            "id": 170876000000133005,
            "type": "Always"
        },
        "link": {
            "self": {
                "url": "https://projects.zoho.com/restapi/portal/2063927/
                        projects/170876000000147021/bugs/170876000001834047/"
            },
            "timesheet": {
                "url": "https://projects.zoho.com/restapi/portal/2063927/
                        projects/170876000000147021/bugs/170876000001834047/logs/"
            }
        },
        "severity": {
            "id": 170876000000065005,
            "type": "Major"
        },
        "reported_person": "Patricia Boyle",
        "id": 170876000001834047,
        "title": "Tilt causes crash",
        "flag": "Internal",
        "assignee_name": "Not Assigned",
        "reporter_id": "2060758",
        "classification": {
            "id": 170876000000133041,
            "type": "Feature(New)"
        },
        "created_time_format": "05-13-2014 05:57 PM",
        "closed": false,
        "created_time": "05-13-2014",
        "key": 541
    }]
}

Create a Bug

Creates a bug.

POST /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/

Scope: ZohoProjects.bugs.CREATE

Request Parameters

title*	String	Name of the bug.
description	String	Description of the bug.
assignee/assignee_zpuid	Long	Specify ZUID of the assignee/Specify ZPUID of the assignee
flag	String	Bug flag must be Internal or External.
classification_id	Long	Classification ID of the project.
milestone_id	Long	Milestone ID of the project.
due_date	String [MM-DD-YYYY]	Due date of the bug.
module_id	Long	Module ID of the project.
severity_id	Long	Severity ID of the project.
reproducible_id	Long	Reproducible ID of the project.
affectedmile_id	Long	Milestone ID of the project.
rate_per_hour	Float	Specify rate per hour if your project budget is based on issue hours.
bug_followers	Long	Follower ID of the user.
uploaddoc	File	The maximum size to upload a file is 128 MB.
Custom Fields
CHAR1 - CHAR12	String	Any text type of custom fields with string or picklist values.
LONG1 - LONG4	Long	Numeric type of custom field.
DATE1 - DATE4	String [MM -DD-YYYY]	Bug custom field in date format.
cost_per_hour	Float	Specify the cast per hour.

Sample Response

Status: 201 Created

Content Type: application/json;charset=utf-8

{
    "bugs": [{
        "id": 170876000001851001,
        "key": "543",
        "project": {
            "id": 170876000000147021
        },
        "flag": "Internal",
        "title": "UI issue in Status text box",
        "reporter_id": "2060758",
        "reported_person": "Patricia Boyle",
        "created_time": "05-27-2014 08:38 AM",
        "created_time_long": 1401188920000,
        "assignee_name": "Not Assigned",
        "classification": {
            "id": 170876000000133041,
            "type": "Feature(New)"
        },
        "severity": {
            "id": 170876000000065005,
            "type": "Major"
        },
        "status": {
            "id": 170876000001077429,
            "type": "known limitation"
        },
        "closed": false,
        "reproducible": {
            "id": 170876000000133005,
            "type": "Always"
        },
        "module": {
            "id": 170876000000494013,
            "name": "ERP Phase I"
        },
        "link": {
            "self": {
                "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/
                        170876000000147021/bugs/170876000001851001/"
            },
            "timesheet": {
                "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/
                        170876000000147021/bugs/170876000001851001/logs/"
            }
        }
    }]
}

Update a Bug

Updates the bug.

POST /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/

Scope: ZohoProjects.bugs.UPDATE

Request Parameters

title	String	Name of the bug.
description	String	Description of the bug.
assignee/assignee_zpuid	Long	Specify ZUID of the assignee/Specify ZPUID of the assignee
flag	String	Bug flag must be Internal or External.
classification_id	Long	Classification ID of the project.
milestone_id	Long	Milestone ID of the project.
due_date	String [MM-DD-YYYY]	Due date of the bug.
module_id	Long	Module ID of the project.
severity_id	Long	Severity ID of the project.
reproducible_id	Long	Reproducible ID of the project.
status_id	Long	Status ID of the project.
resolution	String	Resolution text.
affectedmile_id	Long	Milestone ID of the project.
rate_per_hour	Float	Specify rate per hour if your project budget is based on issue hours.
uploaddoc	File	The maximum size to upload a file is 128 MB.
Custom Fields
CHAR1 - CHAR12	String	Any text type of custom fields with string or picklist values.
LONG1 - LONG4	Long	Numeric type of custom field.
DATE1 - DATE4	String [MM -DD-YYYY]	Bug custom field in date format.
cost_per_hour	Float	Specify the cast per hour.

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8

{
    "bugs": [{
        "id": 170876000001851001,
        "key": "543",
        "project": {
            "id": 170876000000147021
        },
        "flag": "Internal",
        "title": "UI issue in Status options",
        "reporter_id": "2060758",
        "reported_person": "Patricia Boyle",
        "created_time": "05-27-2014 08:38 AM",
        "created_time_long": 1401188920000,
        "assignee_name": "Not Assigned",
        "classification": {
            "id": 170876000000133041,
            "type": "Feature(New)"
        },
        "severity": {
            "id": 170876000000065005,
            "type": "Major"
        },
        "status": {
            "id": 170876000001077429,
            "type": "known limitation"
        },
        "closed": false,
        "reproducible": {
            "id": 170876000000133005,
            "type": "Always"
        },
        "module": {
            "id": 170876000000494013,
            "name": "ERP Phase I"
        },
        "link": {
            "self": {
                "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/
                        170876000000147021/bugs/170876000001851001/"
            },
            "timesheet": {
                "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/
                        170876000000147021/bugs/170876000001851001/logs/"
            }
        }
    }]
}
}

Delete a Bug

Deletes the bug.

DELETE /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/

Scope: ZohoProjects.bugs.DELETE

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8

{
    "response": "Bug Deleted Successfully"
}

Add Comment

Add comment to a bug.

POST /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/comments/

Scope: ZohoProjects.bugs.CREATE

Request Parameters

content	String	Comment
uploaddoc	File	Maximum file size is 128 MB.

Status: 200 Success

Content Type: application/json;charset=utf-8

{
    "comments": [{         
        "comment_id": "170876000004079025",         
        "created_time_long": 1480404045459,         
        "added_by": "2060758",         
        "added_person": "Patricia Boyle",         
        "created_time_format": "11-29-2016 12:50:45 PM",         
        "created_time": "11-29-2016",         
        "comment": "Attach latest screenshot"
    }]
}

Get Comment

Fetch comments for the bug.

GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/comments/

Scope: ZohoProjects.bugs.READ

Request Parameters

index	int	Start index
range	int	Range of bugs (Max limit 100)

Status: 200 Success

Content Type: application/json;charset=utf-8

{
    "comments": [{         
        "updated_time_format": "08-21-2015 02:46:37 PM",         
        "comment_id": "170876000002584007",         
        "created_time_long": 1440078009132,         
        "added_by": "2060758",         
        "updated_time_long": 1440148597805,         
        "added_person": "Patricia Boyle",         
        "updated_by": "2060758",         
        "created_time_format": "08-20-2015 07:10:09 PM",         
        "updated_person": "Patricia Boyle",         
        "created_time": "08-20-2015",         
        "comment": "Attach screenshot for reference.",         
        "updated_time": "08-21-2015"
    }]
}

Get Comments for Multiple Bugs

Fetch comments for multiple bugs.

GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/comments/

Scope: ZohoProjects.bugs.READ

Request Parameters

index	int	Start index
range	int	Range of comments (Max limit 50). If the range exceeds 50, only 50 - limit set by the back end will be fetched.
bug_ids	long	Bug IDs (Max limit is 25 bugs / request)

Status: 200 Success

Content Type: application/json;charset=utf-8

  {

      "index": "1",
      "range": "50",
      "bugscomments": {
        "22736000000117188": {
         "comments": [
          {
           "created_time_long": 1522494111000,
           "created_time": "03-31-2018",
           "created_time_format": "03-31-2018 04:31:51 PM",
           "added_by": "54944035",
           "comment": "Helen Collins :: Please check. issue re-occured.",
           "added_person": "Charles Stone",
           "comment_id": "22736000000117767"
          }
        ],
        "totalcommentscount": "1"
       }
    }
  }

Delete Comment

Delete a bug's comment.

DELETE /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/comments/[COMMENTID]

Scope: ZohoProjects.bugs.DELETE

Status: 200 Success

Content Type: application/json;charset=utf-8

{
  "response": "Bug Comment Deleted Successfully" 
}

Get Bug Timer

Get timer details for a bug.

GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/timer

Scope: ZohoProjects.bugs.READ

Get Bug Custom Views

Get custom views for bugs.

GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/customviews/

Scope: ZohoProjects.bugs.READ

Status: 200 Success

Content Type: application/json;charset=utf-8

{
     "cview_details": [{         
          "is_fav": "false",         
          "cview_id": "170876000002850082",         
          "cview_name": "My Bug"     
}, {         
          "is_fav": "false",         
          "cview_id": "170876000002784151",         
          "cview_name": "Scrum review"     
}, {         
          "is_fav": "false",         
          "cview_id": "170876000002218264",         
          "cview_name": "Modified Today"     
}, {         
          "is_fav": "true",         
          "cview_id": "170876000002043129",         
          "cview_name": "ERP Phase"     
}, {         
          "is_fav": "true",         
          "cview_id": "170876000002043117",         
          "cview_name": "Projects 5.0"
    }]
}

Get Bug Attachments

Get details of attachments for a bug.

GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/attachments/

Scope: ZohoProjects.bugs.READ

Status: 200 Success

Content Type: application/json;charset=utf-8

{
     "attachment_details": [{         
          "attached_time": "11-29-2016",         
          "file_size": "323412",         
          "attached_time_format": "11-29-2016 12:58:36 PM",         
          "author_name": "Patricia Boyle",         
          "author_id": "2060758",         
          "file_uri": "https://projects.zoho.com/portal/zillum/openAttachment/download?file=74e813222afaec070dcb08aee251c02203ed7adc067c731c82d9f6824ba2dea93e22c47ad4d2f3e01fce745875770445",         
          "attached_time_long": 1480404516000,         
          "file_name": "screenshot_1480433316000.png",         
          "file_type": "image/png"
    }]
}

Get Bug Resolution

Get the bug's resolution.

GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/resolution/

Scope: ZohoProjects.bugs.READ

Status: 200 Success

Content Type: application/json;charset=utf-8

{
     "resolution_details": [{
          "resolved_time": "11-29-2016",
          "resolved_time_format": "11-29-2016 01:02:06 PM",
          "issue_id": "170876000003764009",
          "resolved_time_long": 1480404726027,
          "resolver": "Patricia Boyle",
          "resolver_id": "2060758",
          "resolution": "It will taken by content team"
    }]
}

Add Bug Follower

Add follower to a bug.

POST /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/bugfollowers/

Scope: ZohoProjects.bugs.CREATE

Request Parameters

bug_followers

long

User ID

Status: 200 Success

Content Type: application/json;charset=utf-8

{
     "folower_details": [{
         "follower_id": "50929640",
         "issue_id": "170876000003702035",
         "follower_name": "Patricia Boyle"
    }]
}

Get Bug Followers

Get the list of followers for the bug.

GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/bugfollowers/

Scope: ZohoProjects.bugs.READ

Status: 200 Success

Content Type: application/json;charset=utf-8

{
     "issue_follower": [{
         "follower_id": "50929640",
         "issue_id": "170876000003702035",
         "follower_name": "Patricia Boyle"
    }]
}

Delete Bug Follower

Delete follower for a bug.

DELETE /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/bugfollowers/

Scope: ZohoProjects.bugs.DELETE

Status: 200 Success

Content Type: application/json;charset=utf-8

{
     "response": "Bug Followers Deleted Successfully"
}

Bugs Default Fields

Gets all the default fields in the given project.

GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/defaultfields/

Scope: ZohoProjects.bugs.READ

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8

{
    "defaultfields": {
        "severity_details": [{
            "severity_id": "170876000000559001",
            "severity_name": "Show stopper"
        }, {
            "severity_id": "170876000000065003",
            "severity_name": "Critical"
        }, {
            "severity_id": "170876000000065005",
            "severity_name": "Major"
        }, {
            "severity_id": "170876000000065007",
            "severity_name": "Minor"
        }, {
            "severity_id": "170876000000553001",
            "severity_name": "Show Stopper"
        }],
        "status_deatils": [{
            "isdefault": false,
            "status_name": "Open",
            "status_id": "170876000000065045",
            "closed": false
        }, {
            "isdefault": false,
            "status_name": "Assigned",
            "status_id": "170876000000553005",
            "closed": false
        }, {
            "isdefault": false,
            "status_name": "To test",
            "status_id": "170876000000587011",
            "closed": false
        }, {
            "isdefault": false,
            "status_name": "To be fixed",
            "status_id": "170876000001834225",
            "closed": false
        }, {
            "isdefault": false,
            "status_name": "InProgress",
            "status_id": "170876000000065048",
            "closed": false
        }, {
            "isdefault": false,
            "status_name": "Reopen",
            "status_id": "170876000000065057",
            "closed": false
        }, {
            "isdefault": false,
            "status_name": "Closed",
            "status_id": "170876000000065054",
            "closed": true
        }, {
            "isdefault": false,
            "status_name": "To be analyzed",
            "status_id": "170876000000584017",
            "closed": false
        }, {
            "isdefault": false,
            "status_name": "Not an issue",
            "status_id": "170876000001071093",
            "closed": true
        }, {
            "isdefault": false,
            "status_name": "Failed Issues",
            "status_id": "170876000001077005",
            "closed": false
        }, {
            "isdefault": true,
            "status_name": "known limitation",
            "status_id": "170876000001077429",
            "closed": true
        }],
        "module_details": [{
            "module_id": "170876000000170057",
            "module_name": "ERP Phase III"
        }, {
            "module_id": "170876000000494013",
            "module_name": "ERP Phase I"
        }, {
            "module_id": "170876000001023026",
            "module_name": "Post Release - Project 4.0 Feedback"
        }, {
            "module_id": "170876000001829185",
            "module_name": "SAP Phase"
        }],
        "priority_details": [{
            "priority_id": "170876000000133005",
            "priority_name": "Always"
        }, {
            "priority_id": "170876000000133007",
            "priority_name": "Sometimes"
        }, {
            "priority_id": "170876000000133009",
            "priority_name": "Rarely"
        }, {
            "priority_id": "170876000000133011",
            "priority_name": "Unable"
        }, {
            "priority_id": "170876000000133013",
            "priority_name": "NeverTried"
        }, {
            "priority_id": "170876000000133015",
            "priority_name": "NotApplicable"
        }],
        "classification_details": [{
            "classification_id": "170876000000133029",
            "classification_name": "Security"
        }, {
            "classification_id": "170876000001829163",
            "classification_name": "Not a bug"
        }, {
            "classification_id": "170876000000133031",
            "classification_name": "Crash/Hang"
        }, {
            "classification_id": "170876000000133033",
            "classification_name": "DataLoss"
        }, {
            "classification_id": "170876000000133035",
            "classification_name": "Performance"
        }, {
            "classification_id": "170876000000133037",
            "classification_name": "UI/Usabililty"
        }, {
            "classification_id": "170876000000133039",
            "classification_name": "OtherBug"
        }, {
            "classification_id": "170876000000133041",
            "classification_name": "Feature(New)"
        }, {
            "classification_id": "170876000000133043",
            "classification_name": "Enhancement"
        }, {
            "classification_id": "170876000001023022",
            "classification_name": "Support Request"
        }]
    }
}

Bugs Custom Fields

Gets all the custom fields in the given project.

GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/customfields/

Scope: ZohoProjects.bugs.READ

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8

{
    "customfields": [{
        "label_name": "SNo",
        "column_name": "LONG1"
    }, {
        "label_name": "Sub Module",
        "default_Value": "Sales",
        "column_name": "CHAR3"
    }, {
        "label_name": "Browser",
        "default_Value": "Chrome",
        "picklist_values": ["Chrome", "Firefox", "IE", "Safari", "Major"],
        "column_name": "CHAR2"
    }, {
        "label_name": "Product",
        "default_Value": "Code Manager",
        "picklist_values": ["Mapping Manager", "Code Manager"],
        "column_name": "CHAR1"
    }]
}

Bugs Activities

Gets all the activities for the given bug.

GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/activities/

Scope: ZohoProjects.bugs.READ

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8

{
  "activity_details": [
    {
      "current_value": "Screen Shot 2016-04-11 at 1.28.05 PM.png",
      "previous_value": "Screen Shot 2016-04-11 at 1.28.05 PM.png",
      "action_time_long": 1460361462000,
      "action_time_format": "04-11-2016 12:57:42 AM",
      "action": "added",
      "action_by": "Patricia Boyle",
      "action_time": "04-11-2016",
      "action_field": "attachment"
    },
    {
      "current_value": "End result: Not a router problem. It’s Windows doing it – by design",
      "action_time_long": 1460361447615,
      "action_time_format": "04-11-2016 12:57:27 AM",
      "action": "added",
      "action_by": "Patricia Boyle",
      "action_time": "04-11-2016",
      "action_field": "comment"
    },
    {
      "current_value": "1460419200000",
      "previous_value": "",
      "action_time_long": 1460361181000,
      "action_time_format": "04-11-2016 12:53:01 AM",
      "action": "updated",
      "action_by": "Patricia Boyle",
      "action_time": "04-11-2016",
      "action_field": "Resolved Date"
    },
    {
      "current_value": "External",
      "action_time_long": 1459289404000,
      "action_time_format": "03-29-2016 03:10:04 PM",
      "action": "updated",
      "action_by": "Patricia Boyle",
      "action_time": "03-29-2016",
      "action_field": "flag"
    },
    {
      "action_time_long": 1455861568000,
      "action_time_format": "02-18-2016 09:59:28 PM",
      "action": "updated",
      "action_by": "Patricia Boyle",
      "action_time": "02-18-2016",
      "action_field": "description"
    },
    {
      "current_value": "Router failure",
      "previous_value": "router failure",
      "action_time_long": 1455861568000,
      "action_time_format": "02-18-2016 09:59:28 PM",
      "action": "updated",
      "action_by": "Patricia Boyle",
      "action_time": "02-18-2016",
      "action_field": "title"
    },
    {
      "current_value": "Purchasing",
      "previous_value": "none",
      "action_time_long": 1453311828000,
      "action_time_format": "01-20-2016 09:43:48 AM",
      "action": "updated",
      "action_by": "Patricia Boyle",
      "action_time": "01-20-2016",
      "action_field": "affected_milestone"
    },
    {
      "current_value": "Purchasing",
      "previous_value": "none",
      "action_time_long": 1453311824000,
      "action_time_format": "01-20-2016 09:43:44 AM",
      "action": "updated",
      "action_by": "Patricia Boyle",
      "action_time": "01-20-2016",
      "action_field": "milestone"
    },
    {
      "current_value": "Data loss",
      "previous_value": "Feature(New)",
      "action_time_long": 1453123674000,
      "action_time_format": "01-18-2016 05:27:54 AM",
      "action": "updated",
      "action_by": "Patricia Boyle",
      "action_time": "01-18-2016",
      "action_field": "Classification"
    },
    {
      "current_value": "Jasmine Frank",
      "previous_value": "Not Assigned",
      "action_time_long": 1453123674000,
      "action_time_format": "01-18-2016 05:27:54 AM",
      "action": "updated",
      "action_by": "businessrule",
      "action_time": "01-18-2016",
      "action_field": "assignee"
    },
    {
      "current_value": "",
      "previous_value": "",
      "action_time_long": 1450442237000,
      "action_time_format": "12-18-2015 04:37:17 AM",
      "action": "created",
      "action_by": "Patricia Boyle",
      "action_time": "12-18-2015",
      "action_field": "bug"
    },
    {
      "current_value": "In progress",
      "previous_value": "known limitation",
      "action_time_long": 1450442237000,
      "action_time_format": "12-18-2015 04:37:17 AM",
      "action": "updated",
      "action_by": "businessrule",
      "action_time": "12-18-2015",
      "action_field": "status"
    }
  ]
}

Get Renamed Value

Get renamed value of default field.

GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/renamedfields/

Scope: ZohoProjects.bugs.READ

Status: 200 Success

Content Type: application/json;charset=utf-8

{
     "renamed_fields": [{         		
          "actualname": "severity",         
          "replacedname": "Severity"     
    }, {         
          "actualname": "classification",         
          "replacedname": "Classification"     
    }, {         
          "actualname": "isitreproducible",         
          "replacedname": "Is it Reproducible"     
    }, {         
          "actualname": "module",         
          "replacedname": "Module"
    }]
}

Get My Bugs

Lists all the bugs created by you or assigned to you.

GET /restapi/portal/[PORTALID]/mybugs/

Scope: ZohoProjects.bugs.READ

Request Parameters

mybugs_owner	String or Long	Owner of the bug must be identified by User ID or All. (all - String, user ID - Long)
view_type	String	View type of the bug. Accepted values reported owned (default view type)
index	int	Index of the bug.
range	int	Range of the bug.
sort_column	String	Sort bugs using created_time or last_modified_time
sort_order	String	Sort in ascending or descending order.
last_modified_time	Long	The time when the bug was last updated. (In milliseconds)
reverse_order	Boolean	Specify true if the bugs are to be displayed in reverse order, else false.
statustype	String	Bug status. Accepted values open closed

Sample response

Status: 200 
Content Type: application/json;charset=utf-8

 {
  {
  "bugs": [
    {
      "updated_time_long": 1539780373000,
      "comment_count": "0",
      "updated_time": "10-17-2018",
      "flag": "Internal",
      "updated_time_format": "10-17-2018 05:46:13 AM",
      "link": {
        "timesheet": {
          "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/170876000004154005/bugs/170876000005291026/logs/"
        },
        "self": {
          "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/170876000004154005/bugs/170876000005291026/"
        }
      },
      "title": "Water leakage in the third floor needs to be fixed immediately",
      "project_name": "Donnelly Apartments Construction",
      "customfields": [
        {
          "column_name": "CHAR1",
          "label_name": "Social Media ",
          "value": "Facebook"
        }
      ],
      "assignee_name": "Helen Collins",
      "project_id": 170876000004154020,
      "reporter_id": "639283127",
      "id": 170876000005291040,
      "key": "DC-I40",
      "due_date_format": "10-17-2018 05:46:13 AM",
      "assignee_id": "639283127",
      "created_time_long": 1530003531000,
      "severity": {
        "id": 170876000000065000,
        "type": "Major"
      },
      "created_time": "06-26-2018",
      "due_date_long": 1539780373000,
      "created_time_format": "06-26-2018 01:58:51 AM",
      "reproducible": {
        "id": 170876000000133000,
        "type": "Always"
      },
      "module": {
        "name": "Donnelly Apartments Construction",
        "id": 170876000005365020
      },
      "due_date": "10-17-2018",
      "classification": {
        "id": 170876000000133020,
        "type": "OtherBug"
      },
      "milestone": {
        "name": "Cleaning and final walk-through",
        "id": 170876000004154080
      },
      "reported_person": "Helen Collins",
      "closed": false,
      "bug_prefix": "DC",
      "attachment_count": "0",
      "status": {
        "id": 170876000000065060,
        "type": "ToBeTested"
      }
    },
    {
      "updated_time_long": 1539771569000,
      "comment_count": "0",
      "updated_time": "10-17-2018",
      "flag": "Internal",
      "updated_time_format": "10-17-2018 03:19:29 AM",
      "link": {
        "timesheet": {
          "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/170876000004154005/bugs/170876000004848001/logs/"
        },
        "self": {
          "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/170876000004154005/bugs/170876000004848001/"
        }
      },
      "title": "Defective screws found in the first batch imported.",
      "project_name": "Donnelly Apartments Construction",
      "customfields": [
        {
          "column_name": "CHAR1",
          "label_name": "Social Media ",
          "value": "Facebook"
        }
      ],
      "assignee_name": "Helen Collins",
      "project_id": 170876000004154020,
      "reporter_id": "629936858",
      "id": 170876000004848000,
      "key": "DC-I31",
      "due_date_format": "09-16-2018 12:00:00 AM",
      "assignee_id": "639283127",
      "created_time_long": 1506675066000,
      "severity": {
        "id": 170876000000065000,
        "type": "Major"
      },
      "created_time": "09-29-2017",
      "due_date_long": 1537081200000,
      "created_time_format": "09-29-2017 01:51:06 AM",
      "reproducible": {
        "id": 170876000000133000,
        "type": "Always"
      },
      "module": {
        "name": "Donnelly Apartments Construction",
        "id": 170876000005365020
      },
      "due_date": "09-16-2018",
      "classification": {
        "id": 170876000000133020,
        "type": "DataLoss"
      },
      "reported_person": "Patricia Boyle",
      "closed": false,
      "bug_prefix": "DC",
      "attachment_count": "0",
      "status": {
        "id": 170876000000065060,
        "type": "Open"
      }
    }

Get Associated Tasks

Fetches the details of the task associated with an issue.

GET /api/v3/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/tasks

Scope: ZohoProjects.bugs.READ

Sample Response

Status : 200 success 
Content Type: application/json;charset=utf-8

{
    "associated_tasks": [
        {
            "prefix": "ZWA-T5",
            "task_list": {
                "id" : "170876000006061525",
            },
            "project": {
                "id" : "170876000006061251",
            },
            "id": "170876000006061573",
            "name": "Task ",
            "percentage_completed": "0",
            "priority": "High",
            "owners": [
                {
                    "id" : "Fathima Yilmaz"
                }
            ]
        }
    ],
    "page_info": {
        "per_page": 100,
        "has_next_page": false,
        "count": 0,
        "page": 1
    }
}

Associate Tasks

Associate related tasks to an issue.

POST /api/v3/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/tasks

Scope: ZohoProjects.bugs.CREATE

Request Parameters

task_ids

JSON Array

ID of the tasks

Sample Response

Status :200 success
Content Type: application/json;charset=utf-8
{
"is_task_bug_mapped", true
}

Dissociate Tasks

Dissociate tasks from an issue.

DELETE /api/v3/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/task/[TASKID]

Scope: ZohoProjects.bugs.DELETE

Sample Response

Status : 204 success