Favorite

Changed on
post/v2/favorites/{id}/start

Request

  • Base URL
    https://my.clockodo.com/api
  • URL
    https://my.clockodo.com/api/v2/favorites/{id}/start
  • 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

Response

Successful operation

current_timestring date-time required
stopped_has_been_truncatedboolean required
deleted_entries_idsinteger[]

Example response

{
  "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"
  },
  "stopped": {
    "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",
    "time_until": "2023-02-28T00:00:00Z"
  },
  "current_time": "2023-02-28T00:00:00.000Z",
  "additional_message": {
    "type": "warn"
  },
  "truncated_entries": [
    {
      "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

  • d80ab704f3f6Revision changes
    • info

      api operation id createFavoritesStartByIdV2 removed and replaced with startFavoriteByIdV2

  • 38e281d50d6dRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status