Issue Categories¶

• Table of contents
• Issue Categories
  • /projects/:project_id/issue_categories.:format
    • GET
    • POST
  • /issue_categories/:id.:format
    • GET
    • PUT
    • DELETE

/projects/:project_id/issue_categories.:format¶

GET¶

Returns the issue categories available for the project of given id or identifier (:project_id).

Examples:

GET /project/foo/issue_categories.xml
GET /project/1/issue_categories.xml

Response:

<?xml version="1.0" encoding="UTF-8"?>
<issue_categories type="array" total_count="2">
  <issue_category>
    <id>57</id>
    <project name="Foo" id="17"/>
    <name>UI</name>
    <assigned_to name="John Smith" id="22"/>
  </issue_category>
  <issue_category>
    <id>58</id>
    <project name="Foo" id="17"/>
    <name>Test</name>
  </issue_category>
</issue_categories>

POST¶

Creates an issue category for the project of given id or identifier (:project_id).

Parameters:

• issue_category (required): a hash of the issue category attributes, including:
  • name (required)
  • assigned_to_id: the id of the user assigned to the category (new issues with this category are assigned by default to this user)

Response:

• 201 Created: issue category was created
• 422 Unprocessable Entity: issue category was not created due to validation failures (response body contains the error messages)

/issue_categories/:id.:format¶

GET¶

Returns the issue category of given id.

Example:

GET /issue_categories/2.xml

Response:

<?xml version="1.0" encoding="UTF-8"?>
<issue_category>
  <id>2</id>
  <project name="Redmine" id="1"/>
  <name>UI</name>
</version>

PUT¶

Updates the issue category of given id

Parameters:

Same as issue category creation

Response:

• 200 OK: issue category was updated
• 422 Unprocessable Entity: issue category was not updated due to validation failures (response body contains the error messages)

DELETE¶

Deletes the issue category of given id.

Parameters:

• reassign_to_id (optional): when there are issues assigned to the category you are deleting, this parameter lets you reassign these issues to the category with this id

Example:

DELETE /issue_categories/2.xml
DELETE /issue_categories/2.xml?reassign_to_id=1

Response:

• 200 OK: issue category was deleted