Entry

Changed on
put/v2/entries/{id}

Request

  • Base URL
    https://my.clockodo.com/api
  • URL
    https://my.clockodo.com/api/v2/entries/{id}
  • Auth
    • HTTP basic and API key in header X-Clockodo-External-Application
    • or API key in header X-ClockodoApiUser and API key in header X-ClockodoApiKey and API key in header X-Clockodo-External-Application
    • or OAuth 2
      Authorization code: /oauth/authorize
      Token URL: /token

Path parameters

idinteger required
Example:1

Request body

time_sincestring date-time
time_untilstring date-time nullable

May only be null when editing a running clock entry

customers_idinteger
billable0 | 1 | 2 | 12

Possible values:

  • 0: NotBillable
  • 1: Billable
  • 2: Billed
  • 12: BillableOrBilled
projects_idinteger nullable
subprojects_idinteger nullable
services_idinteger
lumpsum_services_idinteger
users_idinteger
durationinteger
lumpsumnumber float
hourly_ratenumber float
lumpsum_services_amountnumber float
textstring

An empty string clears the description

Example request

{
  "time_since": "2023-02-28T12:00:00Z",
  "time_until": "2023-02-28T12:00:00Z"
}

Response

Successful operation

Example response

{
  "entry": {
    "id": 10,
    "customers_id": 10,
    "time_since": "2023-02-28T00:00:00Z",
    "time_insert": "2023-02-28T00:00:00Z",
    "time_last_change": "2023-02-28T00:00:00Z",
    "customers_name": "Hotel Bergblick",
    "projects_name": "Publicity campaign",
    "subprojects_name": "Social media ads",
    "users_name": "Max Mustermann",
    "revenue": 999.9,
    "time_last_change_work_time": "2023-02-28T00:00:00Z",
    "time_clocked_since": "2023-02-28T00:00:00Z",
    "hourly_rate": 99.99,
    "services_name": "SEO service"
  },
  "running": {
    "id": 10,
    "customers_id": 10,
    "time_since": "2023-02-28T00:00:00Z",
    "time_insert": "2023-02-28T00:00:00Z",
    "time_last_change": "2023-02-28T00:00:00Z",
    "customers_name": "Hotel Bergblick",
    "projects_name": "Publicity campaign",
    "subprojects_name": "Social media ads",
    "users_name": "Max Mustermann",
    "revenue": 999.9,
    "time_last_change_work_time": "2023-02-28T00:00:00Z",
    "time_clocked_since": "2023-02-28T00:00:00Z",
    "hourly_rate": 99.99,
    "services_name": "SEO service"
  }
}

Changes

  • 0f27ed36400cRevision changes
    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      added the optional property to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

  • ceedd6dd3446Revision changes
    • breaking

      added to the / response property oneOf list for the response status

    • breaking

      the / response's property type changed from object to no type for status

    • breaking

      the // response's property format changed from int64 to no format for status

    • breaking

      the // response's property type changed from number to no type for status

    • breaking

      the // response's property format changed from int64 to no format for status

    • breaking

      the // response's property type changed from number to no type for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      added the new -1.00 enum value to the // response property for the response status

    • warning

      added the new -1.00 enum value to the // response property for the response status

    • warning

      added the new 1.00 enum value to the // response property for the response status

    • warning

      added the new 1.00 enum value to the // response property for the response status

    • warning

      added the new 2.00 enum value to the // response property for the response status

    • warning

      added the new 2.00 enum value to the // response property for the response status

    • info

      added to the // response property allOf list for the response status

    • info

      added to the // response property allOf list for the response status