PUT

Update an employee time entry

Scope: team:time-tracking.write https://api.alladdin.com/api/v2/employee-times/{timeId}

Updates the start and end times of an existing time tracking entry.

Parameters

Path parameters

timeId string required

Employee time entry ID

Request body

object start_at string<date-time> required

Start time in the user's local timezone. Use ISO 8601 format without UTC offset (e.g. 2026-03-01T09:00:00) so the API interprets it in the account timezone. Do not use +00:00 — it will shift the stored time by the account's UTC offset. Date-only (e.g. 2026-03-01) is also accepted.

end_at string<date-time> required

End time in the user's local timezone. Use ISO 8601 format without UTC offset (e.g. 2026-03-01T17:00:00) so the API interprets it in the account timezone. Do not use +00:00 — it will shift the stored time by the account's UTC offset. Date-only (e.g. 2026-03-01) is also accepted.

pauses[] object[] optional

Optional list of pauses within the time entry. Each pause must be within the start/end range.

start_at string required

Pause start time in local time without timezone offset (e.g. 2026-03-01T14:00:00). Do NOT append +00:00 or Z.

end_at string required

Pause end time in local time without timezone offset (e.g. 2026-03-01T15:00:00). Do NOT append +00:00 or Z.

Request

python

import requests

url = "https://api.alladdin.com/api/v2/employee-times/{timeId}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

payload = {
    "start_at": "2026-03-01T09:00:00",
    "end_at": "2026-03-01T17:00:00",
    "pauses": [
        {
            "start_at": "2026-03-01T14:00:00",
            "end_at": "2026-03-01T15:00:00"
        }
    ]
}
response = requests.put(url, headers=headers, json=payload)
print(response.json())

Responses

Response

json

{
  "id": "string"
}

Success responses

200 Time entry updated application/json object id string

Error responses

400 Bad request application/json 401 Invalid or missing API key application/json 403 Insufficient permissions application/json 404 Time entry not found application/json 422 Validation error application/json 429 Rate limit exceeded application/json

← PreviousResume an employee time session →

Next →List time entries for an employee →

Alladdin