Time entries

Add finished time

View as Markdown

POSThttps://paysuitett.com/api/v1/time-entries

Adds a finished block of time for the key's holder, as "Add time" does in the app. A master key adds it for someone else with `user_id`.

Access. Any key, its holder's own time; a master key anyone's.

Body

A JSON object. Fields marked required must be sent.

user_idstring · uuid
Master key only: whose time it is (from GET /people). The person must track time on projects; the time can't be in the future.
startstring · date-timerequired
Start, ISO 8601 with the offset (Trinidad is -04:00).
endstring · date-timerequired
End, after the start.
task_idstring · uuid
File the time under this task. Takes precedence over the fields below.
project_idstring · uuid
The project, by ID. With `task` (a task name) or, for a project with one task, alone.
projectstring
The project, by its exact name (ignoring case). A name nobody has yet is added on the spot only when `client` is sent too, so a typo doesn't make a project.
clientstring
The client, by name. Only used with `project` to add a new project (and the client, if new).
taskstring
A task name in the project: found, or added if it doesn't exist. Not needed when the project has one task.
descriptionstring
What the work is, up to 2,000 characters.
billableboolean
Billable to the client. Defaults to true.
client_refstring · uuid
A UUID you choose. Sending the same one again returns the entry already added instead of adding it twice, so retries are safe.

Response

201 with a JSON body, as in the example.