---
title: "PUT Timeclock event"
method: PUT
path: "/timeclocks/event/{timeclock}?access_token=xxxxxxx"
---

# PUT Timeclock event

`PUT /timeclocks/event/{timeclock}?access_token=xxxxxxx`

## Request

- Base URL: `https://www.humanity.com/api/v2`
- URL: `https://www.humanity.com/api/v2/timeclocks/event/{timeclock}?access_token=xxxxxxx`
- Auth: API key in query parameter `access_token`

/timeclocks/event/{timeclock}
Permission level: 5

## Query parameters

- `timeclock` integer, required

## Request body `application/x-www-form-urlencoded`

- object
  - `type` string, required: Accepted parameter value is of these constant strings: breakin, breakout, notes, location, position, gps, tips, events
  - `timestamp` string, date: Sets a custom date and time for this timeclock event. If not set, current time will be used. Should be in yyyy-MM-dd hh:mm:ss (24h) format.
  - `notes` string: String variable holding a note. Used only with type=notes.
  - `location` string: String containing an ID or a name of a Remote Site. An ID is usually sent. Used only with type=location.
  - `position` string: String containing an ID or a name of a Position. An ID is usually sent. Used only with type=position.
  - `tips` string: If a setting "Enable Timeclock Tips" is enabled, employees can enter their tip amounts with this parameter. Used only with type=tips.
  - `event` integer: Id of event we want to update
  - `data` string, json: A JSON containing the data which is used when parameter type = events.
  - `gps` string
  - `clocktime` string, json: A JSON containing all data about parent timeclock. Used only when parameter type = events.

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `status` string
    - `events` object
      - `100022881` object
        - `id` string
        - `type` string
        - `timestamp` string
        - `clock_time` string
        - `data` object
          - `notes` string
      - `100022882` object
        - `id` string
        - `type` string
        - `timestamp` string
        - `clock_time` string
        - `data` object
          - `position` integer
      - `100022883` object
        - `id` string
        - `type` string
        - `timestamp` string
        - `clock_time` string
        - `data` object
          - `location` integer
      - `100023219` object
        - `id` string
        - `type` string
        - `timestamp` string
        - `clock_time` string
        - `data` unknown
      - `100023567` object
        - `id` string
        - `type` string
        - `timestamp` string
        - `clock_time` string
        - `data` object
          - `breakin` integer
  - `metadata` unknown[]
    - unknown
  - `token` string
  - `error` unknown

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `ffb87b44c733`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/timeclocks/event/:timeclock%3Faccess_token=xxxxxxx/put.md)

---

[API](https://skmtc.dev/humanity-com/apis/humanity.md) - [All operations](https://skmtc.dev/humanity-com/apis/humanity/llms.txt) - [OpenAPI document](https://skmtc.dev/humanity-com/apis/humanity/revisions/ffb87b44c733?raw)
