Create, update, delete

This document explains how to add, update and delete resources via Trello API. This requires authentication, as explained here.

Creating and modifying resources

The create_resource() function allows you to create new boards, cards, lists and other resources. To create a new resource, specify its type (e.g. “card”) using the resource argument. Further details such as name or description must be passed as a named list using the body argument.

The following example creates a new card and places it at the bottom of a list (see the Trello API reference for query parameters):

library(trelloR)
payload = list(
  name = "My new card!", desc = "An example card.", 
  pos = "bottom",
  idList = list_id # get it by calling get_board_lists()
)
create_resource(model = "card", body = payload)

When successful, the request returns a named list of values describing the newly created resource, including its ID. This is very useful as you can immediately capture the ID if you need it.

The update_resource() function follows the similar logic, but can only be used with existing resources.

To delete resources, use delete_resource(), but beware: Deleted resources cannot be brought back!

Built with

sessionInfo()
#> R version 4.0.3 (2020-10-10)
#> Platform: x86_64-pc-linux-gnu (64-bit)
#> Running under: elementary OS 5.1.7 Hera
#> 
#> Matrix products: default
#> BLAS:   /usr/lib/x86_64-linux-gnu/blas/libblas.so.3.7.1
#> LAPACK: /usr/lib/x86_64-linux-gnu/lapack/liblapack.so.3.7.1
#> 
#> locale:
#>  [1] LC_CTYPE=en_GB.UTF-8       LC_NUMERIC=C              
#>  [3] LC_TIME=cs_CZ.UTF-8        LC_COLLATE=C              
#>  [5] LC_MONETARY=cs_CZ.UTF-8    LC_MESSAGES=en_GB.UTF-8   
#>  [7] LC_PAPER=cs_CZ.UTF-8       LC_NAME=C                 
#>  [9] LC_ADDRESS=C               LC_TELEPHONE=C            
#> [11] LC_MEASUREMENT=cs_CZ.UTF-8 LC_IDENTIFICATION=C       
#> 
#> attached base packages:
#> [1] stats     graphics  grDevices utils     datasets  methods   base     
#> 
#> loaded via a namespace (and not attached):
#>  [1] compiler_4.0.3    magrittr_2.0.1    htmltools_0.5.1.1 tools_4.0.3      
#>  [5] yaml_2.2.1        stringi_1.5.3     rmarkdown_2.6     knitr_1.31       
#>  [9] stringr_1.4.0     digest_0.6.27     xfun_0.20         rlang_0.4.10     
#> [13] evaluate_0.14