Sign in

v1

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

Update Time Record

Update a specific time record by ID. To add or upsert time, use POST /time instead.

put/time/{time_id}

Path parameters

time_idnumber required
Example:8006001

ID of Task 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

OK

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"
    }
  ]
}