From f805627ee9fcffba9f5a509bba652bfd663c6ae7 Mon Sep 17 00:00:00 2001 From: David Lawrence Date: Mon, 11 May 2015 15:36:15 +0100 Subject: Bug 1140575: Comment-creation WebService API should allow tags to be specified r=glob,a=glob --- docs/en/rst/api/core/v1/comment.rst | 35 +++++++++++++++++++---------------- 1 file changed, 19 insertions(+), 16 deletions(-) (limited to 'docs/en/rst/api/core/v1/comment.rst') diff --git a/docs/en/rst/api/core/v1/comment.rst b/docs/en/rst/api/core/v1/comment.rst index 54048122a..45c6fef25 100644 --- a/docs/en/rst/api/core/v1/comment.rst +++ b/docs/en/rst/api/core/v1/comment.rst @@ -105,6 +105,7 @@ is_private boolean ``true`` if this comment is private (only visible to a otherwise. is_markdown boolean ``true`` if this comment needs Markdown processing; ``false`` otherwise. +tags array An array of comment tags currently set for the comment. ============= ======== ======================================================== .. _rest_add_comment: @@ -134,22 +135,24 @@ To create a comment on a current bug. ``ids`` is optional in the data example above and can be used to specify adding a comment to more than one bug at the same time. -=========== ======= =========================================================== -name type description -=========== ======= =========================================================== -**id** int The ID or alias of the bug to append a comment to. -ids array List of integer bug IDs to add the comment to. -**comment** string The comment to append to the bug. If this is empty - or all whitespace, an error will be thrown saying that you - did not set the ``comment`` parameter. -is_private boolean If set to ``true``, the comment is private, otherwise it is - assumed to be public. -is_markdown boolean If set to ``true``, the comment has Markdown structures; - otherwise it is normal text. -work_time double Adds this many hours to the "Hours Worked" on the bug. - If you are not in the time tracking group, this value will - be ignored. -=========== ======= =========================================================== +============ ======= =========================================================== +name type description +============ ======= =========================================================== +**id** int The ID or alias of the bug to append a comment to. +ids array List of integer bug IDs to add the comment to. +**comment** string The comment to append to the bug. If this is empty + or all whitespace, an error will be thrown saying that you + did not set the ``comment`` parameter. +comment_tags array An array of strings to add as comment tags for the new + comment. +is_private boolean If set to ``true``, the comment is private, otherwise it is + assumed to be public. +is_markdown boolean If set to ``true``, the comment has Markdown structures; + otherwise it is normal text. +work_time double Adds this many hours to the "Hours Worked" on the bug. + If you are not in the time tracking group, this value will + be ignored. +============ ======= =========================================================== **Response** -- cgit v1.2.3-24-g4f1b