/entries POST

Enables you to create a new time or timer entry.

If you want to create a new entry, you might supply a piece of XML like this:

<entry>
  <hours>5.0</hours>
  <notes>client meeting in NYC to discuss project requirements</notes>
  <project-id>4096</project-id>
  <tag-s>meetings discovery</tag-s>
</entry>

By using our text-entry syntax this would get even simpler:

<entry>
  <command>client meetings in NYC to discuss project requirements #project_name @meetings @discovery</command>
</entry>

Not all fields may be updated directly; these are:

:created_at, :creator_id, :id, :is_locked, :is_timing, :source, :updated_at

Parameters

command

A text-entry command, over-rides other parameters. Syntax described here.

user-id

Integer ID describing the user to whom the entry is attributed.

User must be a member of the specified project.

hours

The number of hours worked. Can be in the following formats:

1.5, 5, 2h, 45m, 2:30

Leaving the hours blank, or not supplying, will cause the entry to start up as a timer.

is-locked

Defaults to false.

is-timing

Defaults to false.

notes

Text description field.

project-id

Integer ID describing the project to which the entry is attributed.

timer-sessions

Text field describing when timer was started and stopped, delimited by a ‘;’

tag-s

Text field listing tag names for this entry, delimited by white space or commas.