Project

General

Profile

Rest TimeEntries » History » Revision 4

Revision 1 (Jean-Philippe Lang, 2011-01-02 13:01) → Revision 4/15 (yuya ito, 2015-05-30 23:21)

h1. Time Entries 

 {{>toc}} 

 h2. Listing time entries 

   GET /time_entries.xml 

 Returns time entries. 

 h2. Showing a time entry 

   GET /time_entries/[id].xml 

 Returns the time entry of given id. 

 h2. Creating a time entry 

   POST /time_entries.xml 

 Creates a time entry. 

 +Parameters+: 

 * @time_entry@ (required): a hash of the time entry attributes, including: 

   * @issue_id@ or @project_id@ (only one is required): the issue id or project id to log time on 
   * @spent_on@: the date the time was spent (default to the current date) 
   * @hours@ (required): the number of spent hours 
   * @activity_id@: the id of the time activity. This parameter is required unless a default activity is defined in Redmine. 
   * @comments@: short description for the entry (255 characters max) 

 +Response+: 

   * @201 Created@: time entry was created 
   * @422 Unprocessable Entity@: time entry was not created due to validation failures (response body contains the error messages) 

 h2. Updating a time entry 

   PUT /time_entries/[id].xml 

 Updates the time entry of given id. 

 +Parameters+: 

 * @time_entry@ (required): a hash of the time entry attributes (same as above) 

 +Response+: 

   * @200 OK@: time entry was updated 
   * @422 Unprocessable Entity@: time entry was not updated due to validation failures (response body contains the error messages) 

 h2. Deleting a time entry 

   DELETE /time_entries/[id].xml 

 Deletes the time entry of given id.