v1

latestOpenAPI 3.1.1LicenseRef-Proprietary2026-07-1310179223.1 KB
Time Records

Add Time

Add a time record (in seconds) for a user on a given task and date.

Upsert: at most one time record exists per (user, date, task). Posting again with the same combination updates the existing record's duration instead of creating a duplicate. To update a specific record by ID, use PUT /time/{time_id}.

See Dates for accepted date and duration formats.

post/time

Request body

timeinteger required

Time in seconds

datestring

Date

taskstring

Task ID

usernumber

User ID

commentstring

Comment

Example request

{
  "time": 3600,
  "date": "2018-01-20",
  "task": "ev:3000010034",
  "user": 1304,
  "comment": "some notes"
}

Response

Created

idnumber required

Time record ID

timenumber required

Time recorded in seconds

usernumber required

User ID

datestring required

Date

isLockedboolean
isInvoicedboolean
commentstring
createdAtstring

Format: Y-m-d H:i:s

warningobject nullable

Validation warning, if any.

lockReasonsstring[]

Reasons the record is locked, if any.

Example response

{
  "id": 2660155,
  "time": 3600,
  "user": 1304,
  "date": "2018-01-20",
  "task": {
    "id": "ev:9876543210",
    "name": "Task Name",
    "projects": [
      "ev:1234567890"
    ],
    "section": 1234,
    "labels": [
      "high",
      "bug"
    ],
    "position": 1,
    "dueAt": "2018-03-05 16:00:00",
    "status": "open",
    "time": {
      "total": 7200,
      "users": {
        "1304": 3600,
        "1543": 3600
      }
    },
    "estimate": {
      "total": 7200,
      "type": "overall",
      "users": {
        "1304": 3600,
        "1543": 3600
      }
    },
    "attributes": {
      "Client": "Everhour",
      "Priority": "high"
    },
    "metrics": {
      "efforts": 42,
      "expenses": 199
    }
  },
  "comment": "some notes",
  "history": [
    {
      "id": 4622379,
      "createdBy": 1304,
      "time": 3600,
      "action": "TIMER",
      "createdAt": "2018-01-16 12:42:59"
    }
  ]
}