Bugzilla:BzAPI:Objects - Revision history

Mcote: Add deprecation notice

2016-09-21T02:06:28Z

Add deprecation notice

← Older revision		Revision as of 02:06, 21 September 2016
Line 1:		Line 1:
			<div style="border: thin dotted #aaa; padding:5px;">
			'''This specific REST API, generally referred to as "BzAPI", is DEPRECATED. For new projects, use the [[Bugzilla:REST_API\|native REST API]] instead. The BMO team has implemented a [[Bugzilla:BzAPI:CompatLayer\|compatibility layer]] to help existing apps transition off BzAPI onto the native REST API. Please migrate existing BzAPI-based apps to the new compatibility-layer endpoint as soon as possible, as BzAPI will be shut off at some point in the future. Direct any questions to the [[BMO]] team.

			'''The native REST API is available in Bugzilla 5.0 and up, and on bugzilla.mozilla.org. Although BzAPI is deprecated, it can be used with older Bugzilla installations (versions prior to 5.0) to provide a REST API.'''
			</div><br>

	This page lists the objects used on the [[Bugzilla:BzAPI]], and the fields of each, along with their types, descriptions, and any names those fields may have in other contexts.		This page lists the objects used on the [[Bugzilla:BzAPI]], and the fields of each, along with their types, descriptions, and any names those fields may have in other contexts.

Kevingrandon: Add suggested reviewer object type.

2014-11-10T11:20:20Z

Add suggested reviewer object type.

@@ Line 241: / Line 241: @@
 |-
 |ref||String, Read Only||URL of user in API||
 |}

Edmorley: Fix link to BzAPI

2014-07-07T19:30:45Z

Fix link to BzAPI

← Older revision		Revision as of 19:30, 7 July 2014
Line 1:		Line 1:
	This page lists the objects used on the [[Bugzilla:~~REST_API~~]], and the fields of each, along with their types, descriptions, and any names those fields may have in other contexts.		This page lists the objects used on the [[Bugzilla:BzAPI]], and the fields of each, along with their types, descriptions, and any names those fields may have in other contexts.

	====Notes====		====Notes====

Edmorley: Edmorley moved page Bugzilla:REST API:Objects to Bugzilla:BzAPI:Objects: Native REST

2014-07-07T16:53:30Z

Edmorley moved page Bugzilla:REST API:Objects to Bugzilla:BzAPI:Objects: Native REST

← Older revision	Revision as of 16:53, 7 July 2014
(No difference)

Gerv: /* Flag */

2013-09-17T12:32:02Z

Flag

← Older revision		Revision as of 12:32, 17 September 2013
Line 145:		Line 145:
	\|name\|\|String, Read Only\|\|Descriptive non-unique name for flag type, e.g. 'review'\|\|		\|name\|\|String, Read Only\|\|Descriptive non-unique name for flag type, e.g. 'review'\|\|
	\|-		\|-
	\|requestee\|\|~~String~~, Optional\|\|User action is requested from, if flag is requestable; can only be set if setting status to '?'\|\|		\|requestee\|\|[[#User\|User]], Optional\|\|User action is requested from, if flag is requestable; can only be set if setting status to '?'\|\|
	\|-		\|-
	\|setter\|\|[[#User\|User]], Read Only\|\|User who set the flag\|\|		\|setter\|\|[[#User\|User]], Read Only\|\|User who set the flag\|\|

Gerv: /* Bug */

2013-03-07T12:05:33Z

Bug

← Older revision		Revision as of 12:05, 7 March 2013
Line 24:		Line 24:
	\|-		\|-
	\|attachments\|\|Array of [[#Attachment\|Attachment]]\|\|Related files stored by Bugzilla\|\|attachment		\|attachments\|\|Array of [[#Attachment\|Attachment]]\|\|Related files stored by Bugzilla\|\|attachment
	\|-		\|- style="font-weight: bold"
	\|blocks\|\|Array of Integer\|\|IDs of bugs which can only be fixed after this one\|\|blocked		\|blocks\|\|Array of Integer\|\|IDs of bugs which can only be fixed after this one (note: only returned by default in Bugzilla > 4.4 or BMO 4.2)\|\|blocked
	\|-		\|-
	\|cc\|\|Array of [[#User\|User]]\|\|Users signed up to be notified of changes\|\|		\|cc\|\|Array of [[#User\|User]]\|\|Users signed up to be notified of changes\|\|
Line 40:		Line 40:
	\|- style="font-weight: bold"		\|- style="font-weight: bold"
	\|deadline\|\|Datestamp String\|\|Date by which bug must be fixed\|\|		\|deadline\|\|Datestamp String\|\|Date by which bug must be fixed\|\|
	\|-		\|- style="font-weight: bold"
	\|depends_on\|\|Array of Integer\|\|Bugs that must be fixed first\|\|dependson		\|depends_on\|\|Array of Integer\|\|Bugs that must be fixed first (note: only returned by default in Bugzilla > 4.4 or BMO 4.2)\|\|dependson
	\|-		\|-
	\|dupe_of\|\|Integer\|\|Bug number of which this bug is a duplicate (only present if bug is RESOLVED DUPLICATE)\|\|		\|dupe_of\|\|Integer\|\|Bug number of which this bug is a duplicate (only present if bug is RESOLVED DUPLICATE)\|\|

Gerv: Add internal links

2011-03-18T15:28:52Z

Add internal links

← Older revision		Revision as of 15:28, 18 March 2011
Line 6:		Line 6:
	* Fields marked Read Only are set automatically by Bugzilla, based on other information or fields. They may be returned by GET calls, but will be ignored in POST or PUT. (So you don't have to remove them before sending an object back.)		* Fields marked Read Only are set automatically by Bugzilla, based on other information or fields. They may be returned by GET calls, but will be ignored in POST or PUT. (So you don't have to remove them before sending an object back.)
	* Fields marked No Mod can be set when the object is created, but are Read Only thereafter.		* Fields marked No Mod can be set when the object is created, but are Read Only thereafter.
	* For the objects other than Bug, some fields are marked Optional to show that they are not always present. For a Bug, all fields should be considered Optional apart from "id" and "ref".		* For the objects other than [[#Bug\|Bug]], some fields are marked Optional to show that they are not always present. For a [[#Bug\|Bug]], all fields should be considered Optional apart from "id" and "ref".
	* For fields of type Boolean, on submit, please use "1" and "0" for true and false. This may get relaxed later.		* For fields of type Boolean, on submit, please use "1" and "0" for true and false. This may get relaxed later.
	* Fields of type Timestamp should be sent and received in the UTC timezone in ISO 8601 format - YYYY-MM-DDTHH:MM:SSZ (T and Z being a literal "T" and "Z").		* Fields of type Timestamp should be sent and received in the UTC timezone in ISO 8601 format - YYYY-MM-DDTHH:MM:SSZ (T and Z being a literal "T" and "Z").
Line 21:		Line 21:
	\|alias\|\|String\|\|Bug's alias (text alternative to ID)\|\|		\|alias\|\|String\|\|Bug's alias (text alternative to ID)\|\|
	\|- style="font-weight: bold"		\|- style="font-weight: bold"
	\|assigned_to\|\|User\|\|User responsible for the bug\|\|		\|assigned_to\|\|[[#User\|User]]\|\|User responsible for the bug\|\|
	\|-		\|-
	\|attachments\|\|Array of [[#Attachment\|Attachment]]\|\|Related files stored by Bugzilla\|\|attachment		\|attachments\|\|Array of [[#Attachment\|Attachment]]\|\|Related files stored by Bugzilla\|\|attachment
Line 27:		Line 27:
	\|blocks\|\|Array of Integer\|\|IDs of bugs which can only be fixed after this one\|\|blocked		\|blocks\|\|Array of Integer\|\|IDs of bugs which can only be fixed after this one\|\|blocked
	\|-		\|-
	\|cc\|\|Array of User\|\|Users signed up to be notified of changes\|\|		\|cc\|\|Array of [[#User\|User]]\|\|Users signed up to be notified of changes\|\|
	\|- style="font-weight: bold"		\|- style="font-weight: bold"
	\|classification\|\|String\|\|Name of classification (categorization above product)\|\|		\|classification\|\|String\|\|Name of classification (categorization above product)\|\|
	\|-		\|-
	\|comments\|\|Array of Comment\|\|Things people have said about the bug\|\|long_desc		\|comments\|\|Array of [[#Comment\|Comment]]\|\|Things people have said about the bug\|\|long_desc
	\|- style="font-weight: bold"		\|- style="font-weight: bold"
	\|component\|\|String\|\|Bug's component (sub-product)\|\|		\|component\|\|String\|\|Bug's component (sub-product)\|\|
Line 37:		Line 37:
	\|creation_time\|\|Timestamp String, Read Only\|\|When bug was filed\|\|creation_ts, opendate		\|creation_time\|\|Timestamp String, Read Only\|\|When bug was filed\|\|creation_ts, opendate
	\|- style="font-weight: bold"		\|- style="font-weight: bold"
	\|creator\|\|User, Read Only\|\|User who submitted the bug\|\|reporter		\|creator\|\|[[#User\|User]], Read Only\|\|User who submitted the bug\|\|reporter
	\|- style="font-weight: bold"		\|- style="font-weight: bold"
	\|deadline\|\|Datestamp String\|\|Date by which bug must be fixed\|\|		\|deadline\|\|Datestamp String\|\|Date by which bug must be fixed\|\|
Line 47:		Line 47:
	\|estimated_time\|\|Decimal\|\|Current estimated time for fix, in hours\|\|		\|estimated_time\|\|Decimal\|\|Current estimated time for fix, in hours\|\|
	\|-		\|-
	\|flags\|\|Array of Flag\|\|Flags set on this bug\|\|		\|flags\|\|Array of [[#Flag\|Flag]]\|\|Flags set on this bug\|\|
	\|-		\|-
	\|groups\|\|Array of Group\|\|Groups to which this bug belongs\|\|		\|groups\|\|Array of [[#Group\|Group]]\|\|Groups to which this bug belongs\|\|
	\|-		\|-
	\|history\|\|Array of ChangeSet, Read Only\|\|Changes made to bug fields in the past (requires 3.4)\|\|		\|history\|\|Array of [[#ChangeSet\|ChangeSet]], Read Only\|\|Changes made to bug fields in the past (requires 3.4)\|\|
	\|- style="font-weight: bold"		\|- style="font-weight: bold"
	\|id\|\|Integer, Read Only\|\|Unique numeric identifier for bug\|\|bug_id		\|id\|\|Integer, Read Only\|\|Unique numeric identifier for bug\|\|bug_id
Line 73:		Line 73:
	\|product\|\|String\|\|Name of product\|\|		\|product\|\|String\|\|Name of product\|\|
	\|- style="font-weight: bold"		\|- style="font-weight: bold"
	\|qa_contact\|\|User\|\|User responsible for checking bug is fixed\|\|		\|qa_contact\|\|[[#User\|User]]\|\|User responsible for checking bug is fixed\|\|
	\|- style="font-weight: bold"		\|- style="font-weight: bold"
	\|ref\|\|String, Read Only\|\|URL of bug in API\|\|		\|ref\|\|String, Read Only\|\|URL of bug in API\|\|
Line 113:		Line 113:
	\|attachment_ref\|\|String, Read Only\|\|Ref of attachment added at the same time as this comment, if any; 3.6 or above and /comment call only\|\|		\|attachment_ref\|\|String, Read Only\|\|Ref of attachment added at the same time as this comment, if any; 3.6 or above and /comment call only\|\|
	\|-		\|-
	\|creator\|\|User, Read Only\|\|User who wrote the comment\|\|		\|creator\|\|[[#User\|User]], Read Only\|\|User who wrote the comment\|\|
	\|-		\|-
	\|creation_time\|\|Timestamp String, Read Only\|\|Time comment was added\|\|		\|creation_time\|\|Timestamp String, Read Only\|\|Time comment was added\|\|
Line 147:		Line 147:
	\|requestee\|\|String, Optional\|\|User action is requested from, if flag is requestable; can only be set if setting status to '?'\|\|		\|requestee\|\|String, Optional\|\|User action is requested from, if flag is requestable; can only be set if setting status to '?'\|\|
	\|-		\|-
	\|setter\|\|User, Read Only\|\|User who set the flag\|\|		\|setter\|\|[[#User\|User]], Read Only\|\|User who set the flag\|\|
	\|-		\|-
	\|status\|\|String\|\|Flag value - '?', '+', '-' or 'X'\|\|		\|status\|\|String\|\|Flag value - '?', '+', '-' or 'X'\|\|
Line 161:		Line 161:
	!Name!!Type!!Description!!Other Names		!Name!!Type!!Description!!Other Names
	\|-		\|-
	\|changer\|\|User\|\|Who made the changes\|\|		\|changer\|\|[[#User\|User]]\|\|Who made the changes\|\|
	\|-		\|-
	\|changes\|\|Array of Change\|\|The changes made in one change submission\|\|		\|changes\|\|Array of [[#Change\|Change]]\|\|The changes made in one change submission\|\|
	\|-		\|-
	\|change_time\|\|Timestamp String\|\|When the changes were made\|\|		\|change_time\|\|Timestamp String\|\|When the changes were made\|\|
Line 187:		Line 187:
	!Name!!Type!!Description!!Other Names		!Name!!Type!!Description!!Other Names
	\|-		\|-
	\|attacher\|\|User, Read Only\|\|User who created attachment\|\|		\|attacher\|\|[[#User\|User]], Read Only\|\|User who created attachment\|\|
	\|-		\|-
	\|bug_id\|\|Integer, Read Only\|\|ID if bug to which this is an attachment\|\|		\|bug_id\|\|Integer, Read Only\|\|ID if bug to which this is an attachment\|\|
Line 193:		Line 193:
	\|bug_ref\|\|String, Read Only\|\|URL of associated bug in API\|\|		\|bug_ref\|\|String, Read Only\|\|URL of associated bug in API\|\|
	\|-		\|-
	\|comments\|\|Array of Comment, Optional, Submit Only\|\|Bug comment associated with creation or change (only first element in array is looked at)\|\|		\|comments\|\|Array of [[#Comment\|Comment]], Optional, Submit Only\|\|Bug comment associated with creation or change (only first element in array is looked at)\|\|
	\|-		\|-
	\|creation_time\|\|Timestamp String, Read Only\|\|When attachment was submitted\|\|		\|creation_time\|\|Timestamp String, Read Only\|\|When attachment was submitted\|\|
Line 205:		Line 205:
	\|file_name\|\|String\|\|Path-less filename of attachment\|\|		\|file_name\|\|String\|\|Path-less filename of attachment\|\|
	\|-		\|-
	\|flags\|\|Array of Flag\|\|Flags set on this attachment\|\|		\|flags\|\|Array of [[#Flag\|Flag]]\|\|Flags set on this attachment\|\|
	\|-		\|-
	\|id\|\|Integer, Read Only\|\|Unique numeric identifier for attachment\|\|attach_id		\|id\|\|Integer, Read Only\|\|Unique numeric identifier for attachment\|\|attach_id
Line 261:		Line 261:
	\|}		\|}

	* Error objects are distinguished from other objects because they have an "error" member set to a true value. You should test every API return to see if it is an Error.		* Error objects are distinguished from other objects because they have an "error" member set to a true value. You should test every API return to see if it is an [[#Error\|Error]].

Gerv at 15:18, 18 March 2011

2011-03-18T15:18:38Z

← Older revision		Revision as of 15:18, 18 March 2011
Line 23:		Line 23:
	\|assigned_to\|\|User\|\|User responsible for the bug\|\|		\|assigned_to\|\|User\|\|User responsible for the bug\|\|
	\|-		\|-
	\|attachments\|\|Array of Attachment\|\|Related files stored by Bugzilla\|\|attachment		\|attachments\|\|Array of [[#Attachment\|Attachment]]\|\|Related files stored by Bugzilla\|\|attachment
	\|-		\|-
	\|blocks\|\|Array of Integer\|\|IDs of bugs which can only be fixed after this one\|\|blocked		\|blocks\|\|Array of Integer\|\|IDs of bugs which can only be fixed after this one\|\|blocked

Gerv at 16:43, 2 February 2011

2011-02-02T16:43:36Z

← Older revision		Revision as of 16:43, 2 February 2011
Line 36:		Line 36:
	\|- style="font-weight: bold"		\|- style="font-weight: bold"
	\|creation_time\|\|Timestamp String, Read Only\|\|When bug was filed\|\|creation_ts, opendate		\|creation_time\|\|Timestamp String, Read Only\|\|When bug was filed\|\|creation_ts, opendate
			\|- style="font-weight: bold"
			\|creator\|\|User, Read Only\|\|User who submitted the bug\|\|reporter
	\|- style="font-weight: bold"		\|- style="font-weight: bold"
	\|deadline\|\|Datestamp String\|\|Date by which bug must be fixed\|\|		\|deadline\|\|Datestamp String\|\|Date by which bug must be fixed\|\|
Line 55:		Line 57:
	\|is_cc_accessible\|\|Boolean\|\|Whether CC list can see bug, regardless of groups\|\|cclist_accessible		\|is_cc_accessible\|\|Boolean\|\|Whether CC list can see bug, regardless of groups\|\|cclist_accessible
	\|-		\|-
	\|~~is_everconfirmed~~\|\|Boolean, Read Only\|\|Whether bug has ever passed from UNCONFIRMED to CONFIRMED status\|\|everconfirmed		\|is_confirmed\|\|Boolean, Read Only\|\|Whether bug has ever passed from UNCONFIRMED to CONFIRMED status\|\|everconfirmed, is_everconfirmed
	\|-		\|-
	\|~~is_reporter_accessible~~\|\|Boolean\|\|Whether reporter can see bug, regardless of groups\|\|reporter_accessible		\|is_creator_accessible\|\|Boolean\|\|Whether creator (reporter) can see bug, regardless of groups\|\|reporter_accessible, is_reporter_accessible
	\|- style="font-weight: bold"		\|- style="font-weight: bold"
	\|keywords\|\|Array of String\|\|Tags (from a limited set) describing the bug\|\|		\|keywords\|\|Array of String\|\|Tags (from a limited set) describing the bug\|\|
Line 76:		Line 78:
	\|- style="font-weight: bold"		\|- style="font-weight: bold"
	\|remaining_time\|\|Decimal, Read Only\|\|Hours left before fix will be done\|\|		\|remaining_time\|\|Decimal, Read Only\|\|Hours left before fix will be done\|\|
	~~\|- style="font-weight: bold"~~
	~~\|reporter\|\|User, Read Only\|\|User who submitted the bug\|\|~~
	\|- style="font-weight: bold"		\|- style="font-weight: bold"
	\|resolution\|\|String\|\|The resolution, if the bug is in a closed state, e.g. FIXED, DUPLICATE\|\|		\|resolution\|\|String\|\|The resolution, if the bug is in a closed state, e.g. FIXED, DUPLICATE\|\|
Line 91:		Line 91:
	\|target_milestone\|\|String\|\|When the bug is going to be fixed\|\|		\|target_milestone\|\|String\|\|When the bug is going to be fixed\|\|
	\|-		\|-
	\|~~token~~\|\|String\|\|Token you'll need to submit to change the bug; supplied only when logged in\|\|		\|update_token\|\|String\|\|Token you'll need to submit to change the bug; supplied only when logged in\|\|token
	\|- style="font-weight: bold"		\|- style="font-weight: bold"
	\|url\|\|String\|\|URL relating to the bug (in search defaults only on 4.0 and above)\|\|bug_file_loc		\|url\|\|String\|\|URL relating to the bug (in search defaults only on 4.0 and above)\|\|bug_file_loc
Line 219:		Line 219:
	\|size\|\|Integer\|\|Size of attachment, in bytes\|\|		\|size\|\|Integer\|\|Size of attachment, in bytes\|\|
	\|-		\|-
	\|~~token~~\|\|String, Optional\|\|Token to submit to change attachment metadata; supplied only when logged in\|\|		\|update_token\|\|String, Optional\|\|Token to submit to change attachment metadata; supplied only when logged in\|\|token
	\|-		\|-
	\|content_type\|\|String\|\|MIME type of attachment\|\|		\|content_type\|\|String\|\|MIME type of attachment\|\|

Gerv: /* Comment */

2010-11-14T11:14:16Z

Comment

← Older revision		Revision as of 11:14, 14 November 2010
Line 113:		Line 113:
	\|attachment_ref\|\|String, Read Only\|\|Ref of attachment added at the same time as this comment, if any; 3.6 or above and /comment call only\|\|		\|attachment_ref\|\|String, Read Only\|\|Ref of attachment added at the same time as this comment, if any; 3.6 or above and /comment call only\|\|
	\|-		\|-
	\|~~author~~\|\|User, Read Only\|\|User who wrote the comment\|\|		\|creator\|\|User, Read Only\|\|User who wrote the comment\|\|
	\|-		\|-
	\|creation_time\|\|Timestamp String, Read Only\|\|Time comment was added\|\|		\|creation_time\|\|Timestamp String, Read Only\|\|Time comment was added\|\|