Versions¶

• Table of contents
• Versions
  • /projects/:project_id/versions.:format
    • GET
    • POST
  • /projects/:project_id/versions/:id.:format
    • GET
    • PUT
    • DELETE

/projects/:project_id/versions.:format¶

GET¶

Returns the versions available for the project of given id or identifier (:project_id). The response may include shared versions from other projects.

Examples:

GET /project/foo/versions.xml
GET /project/1/versions.xml

Response:

<?xml version="1.0" encoding="UTF-8"?>
<versions type="array" total_count="34">
  <version>
    <id>1</id>
    <project name="Redmine" id="1"/>
    <name>0.7</name>
    <description/>
    <status>closed</status>
    <due_date>2008-04-28</due_date>
    <created_on>2008-03-09T12:52:06+01:00</created_on>
    <updated_on>2009-11-15T12:22:12+01:00</updated_on>
  </version>
  <version>
    <id>2</id>
    <project name="Redmine" id="1"/>
    <name>0.8</name>
    <description/>
    <status>closed</status>
    <due_date>2008-12-30</due_date>
    <created_on>2008-03-09T12:52:12+01:00</created_on>
    <updated_on>2009-11-15T12:22:12+01:00</updated_on>
  </version>
</versions>

POST¶

Creates a version for the project of given id or identifier (:project_id).

Parameters:

• version (required): a hash of the version attributes, including:
  • name (required)
  • status: the status of the version (in: "open", "locked", "closed")
  • sharing: the version sharing (in: "none", "descendants", "hierarchy", "tree", "system")
  • due_date
  • description

Response:

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

/projects/:project_id/versions/:id.:format¶

GET¶

Returns the version of given id.

Example:

GET /projects/foo/versions/2.xml

Response:

<?xml version="1.0" encoding="UTF-8"?>
<version>
  <id>2</id>
  <project name="Redmine" id="1"/>
  <name>0.8</name>
  <description/>
  <status>closed</status>
  <due_date>2008-12-30</due_date>
  <created_on>2008-03-09T12:52:12+01:00</created_on>
  <updated_on>2009-11-15T12:22:12+01:00</updated_on>
</version>

PUT¶

Updates the version of given id

Parameters:

Same as version creation

Response:

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

DELETE¶

Deletes the version of given id.

Response:

• 200 OK: version was deleted
• 422 Unprocessable Entity: version was not deleted (response body contains the error messages)