{clockify}

clockify

CRAN status Travis-CI build status Codecov test coverage Lifecycle: experimental

An R wrapper around the Clockify API.

The documentation for {clockify} is hosted at https://datawookie.github.io/clockify/.

API Key

You’re going to need to have an API key from your Clockify account. If you don’t yet have an account, create one. Then retrieve the API key from the account settings.

Get Started

The first thing you’ll need to do is set up your API key. I store mine in an environment variable called CLOCKIFY_API_KEY.

CLOCKIFY_API_KEY <- Sys.getenv("CLOCKIFY_API_KEY")

Now load the {clockify} package and specify the API key.

library(clockify)

set_api_key(CLOCKIFY_API_KEY)

Let’s turn on some logging so we can see what’s happening behind the scenes.

library(logger)

log_threshold(DEBUG)

Workspaces

Retrieve a list of available workspaces.

workspaces()
2022-10-19 16:44:47 — GET https://api.clockify.me/api/v1/workspaces

# A tibble: 3 × 3
  workspace_id             name               memberships      
  <chr>                    <chr>              <list>           
1 5ef46294df73063139f60bfc Fathom Data        <tibble [17 × 6]>
2 61343c45ab05e02be2c8c1fd Personal           <tibble [2 × 4]> 
3 630c61ba9c3a3c3112812332 {clockify} sandbox <tibble [5 × 6]>

Select a specific workspace.

workspace("630c61ba9c3a3c3112812332")
2022-10-19 16:44:47 — Set active workspace -> 630c61ba9c3a3c3112812332.

[1] "630c61ba9c3a3c3112812332"

Users

Retrieve information on your user profile.

user()
2022-10-19 16:44:47 — GET https://api.clockify.me/api/v1/user

# A tibble: 1 × 3
  user_id                  user_name status
  <chr>                    <chr>     <chr> 
1 5f227e0cd7176a0e6e754409 Andrew    ACTIVE

Get a list of users.

users()
2022-10-19 16:44:47 — GET https://api.clockify.me/api/v1/workspaces/630c61ba9c3a3c3112812332/users

# A tibble: 5 × 3
  user_id                  user_name   status                    
  <chr>                    <chr>       <chr>                     
1 5f227e0cd7176a0e6e754409 Andrew      ACTIVE                    
2 630f17f04a05b20faf7e0afc Bob Smith   ACTIVE                    
3 630f16ab90cfd878937a7997 <NA>        NOT_REGISTERED            
4 630f1cb9cb18da61cfd58659 Carol Brown PENDING_EMAIL_VERIFICATION
5 630f15d3b59c366b0e3ae2e6 Alice Jones ACTIVE

Clients

Get a list of clients.

clients()
2022-10-19 16:44:47 — GET https://api.clockify.me/api/v1/workspaces/630c61ba9c3a3c3112812332/clients
2022-10-19 16:44:47 — Page contains 1 results.
2022-10-19 16:44:47 — API returned 1 results.

# A tibble: 1 × 3
  client_id                workspace_id             client_name
  <chr>                    <chr>                    <chr>      
1 630ce46090cfd8789366f4fb 630c61ba9c3a3c3112812332 RStudio

Projects

Get a list of projects.

projects()
2022-10-19 16:44:47 — GET https://api.clockify.me/api/v1/workspaces/630c61ba9c3a3c3112812332/projects
2022-10-19 16:44:47 — Page contains 3 results.
2022-10-19 16:44:47 — API returned 3 results.

# A tibble: 3 × 5
  project_id               project_name client_id                billa…¹ archi…²
  <chr>                    <chr>        <chr>                    <lgl>   <lgl>  
1 632a94f8d801fa1178d366b8 test         <NA>                     TRUE    FALSE  
2 630ce53290cfd8789366fd49 {clockify}   630ce46090cfd8789366f4fb TRUE    FALSE  
3 630ce53cb59c366b0e27743f {emayili}    630ce46090cfd8789366f4fb TRUE    FALSE  
# … with abbreviated variable names ¹​billable, ²​archived

Time Entries

Retrieve Time Entries

Retrieve the time entries for the authenticated user.

time_entries()

Retrieve time entries for another user specified by their user ID.

time_entries(user_id = "630f15d3b59c366b0e3ae2e6")

Insert Time Entry

prepare_cran_entry <- time_entry_create(
  project_id = "630ce53290cfd8789366fd49",
  start = "2021-08-30 08:00:00",
  end = "2021-08-30 10:30:00",
  description = "Prepare for CRAN submission"
)
2022-10-19 16:44:48 — POST https://api.clockify.me/api/v1/workspaces/630c61ba9c3a3c3112812332/time-entries

Check on the ID for this new time entry.

prepare_cran_entry$time_entry_id
[1] "63501b7041407109a86a9737"

Confirm that it has been inserted.

time_entries(concise = FALSE) %>%
  select(time_entry_id, description, time_start, time_end)
2022-10-19 16:44:48 — GET https://api.clockify.me/api/v1/user
2022-10-19 16:44:48 — GET https://api.clockify.me/api/v1/workspaces/630c61ba9c3a3c3112812332/user/5f227e0cd7176a0e6e754409/time-entries
2022-10-19 16:44:48 — Page contains 3 results.
2022-10-19 16:44:48 — API returned 3 results.

# A tibble: 3 × 4
  time_entry_id            description   time_start          time_end           
  <chr>                    <chr>         <dttm>              <dttm>             
1 63501ac741407109a86a96f6 Prepare for … 2021-08-30 08:00:00 2021-08-30 10:30:00
2 63501add7e299f5e61cd1a0a Prepare for … 2021-08-30 08:00:00 2021-08-30 10:30:00
3 63501b7041407109a86a9737 Prepare for … 2021-08-30 08:00:00 2021-08-30 10:30:00

Delete Time Entry

time_entry_delete(prepare_cran_entry$time_entry_id)
2022-10-19 16:44:48 — DELETE https://api.clockify.me/api/v1/workspaces/630c61ba9c3a3c3112812332/time-entries/63501b7041407109a86a9737

[1] TRUE

Confirm that it has been deleted.

time_entries(concise = FALSE) %>%
  select(time_entry_id, description, time_start, time_end)
2022-10-19 16:44:48 — GET https://api.clockify.me/api/v1/user
2022-10-19 16:44:48 — GET https://api.clockify.me/api/v1/workspaces/630c61ba9c3a3c3112812332/user/5f227e0cd7176a0e6e754409/time-entries
2022-10-19 16:44:48 — Page contains 2 results.
2022-10-19 16:44:48 — API returned 2 results.

# A tibble: 2 × 4
  time_entry_id            description   time_start          time_end           
  <chr>                    <chr>         <dttm>              <dttm>             
1 63501ac741407109a86a96f6 Prepare for … 2021-08-30 08:00:00 2021-08-30 10:30:00
2 63501add7e299f5e61cd1a0a Prepare for … 2021-08-30 08:00:00 2021-08-30 10:30:00

Endpoints

Endpoints which have currently been implemented in this package. Endpoints which are only available on a paid plan are indicated with a 💰.