get_users() now supports filtering users with the account_status and
user_role parameters. For example, this allows you to find all licensed
users on a Connect server. (#311)set_thumbnail(), get_thumbnail(), delete_thumbnail() and
has_thumbnail() let you interact with content thumbnails, replacing older
*_image() functions. (#294, #304)groups_create_remote() now has an exact parameter. Setting exact causes
the function to consider only exact group name matches when searching for
remote groups and checking for existing local groups. (#216)get_runtime_caches(), delete_runtime_cache() (#312)get_runtimes() lets you view available runtimes and versions on a
Connect server. (#311)set_image_path(), set_image_url(), and set_image_webshot() have been
deprecated and will be removed in a future update. They have been replaced by
set_thumbnail(), which works both with local file paths and remote URLs to
images. Likewise, has_image() and delete_image() have been deprecated in
favor of has_thumbnail() and delete_thumbnail(). (#294, #304)Connect$server_settings_r() has been deprecated in favor of
get_runtimes(client, "r"). (#311)pkgdown to bootstrap 5 to enable search (@fh-mthomson, #275)get_timezones() function now uses the v1/timezones endpoint if
available. (#300)connect$DELETE() now respects the parser argument rather than always using
NULL.get_groups() no longer hangs when a search prefix is provided. (#319)GET_URL(), GET_RESULT(), and GET_RESULT_URL() have been eliminated in
favor of GET() (#274)..empty_object argument has been removed from PUT/PATCH/POST (#274).content_render() and content_restart() functions. content_render()
allows you to programmatically re-render content such as Quarto and R Markdown
reports and Jupyter notebooks, optionally passing in a variant_key to render
a specific variant of parameterized content. content_restart() lets you
restart interactive content, such as Shiny applications, APIs, or dashboards
(#283, #289)get_oauth_credentials() function for interacting with Connect's
/v1/oauth/integrations/credentials endpoint. This endpoint allows content
running on Posit Connect to obtain the content viewer's OAuth access token
(#297).NA
(#290).httr_response object (#274).Connect$download_bundle() and
Connect$bundle_delete() have been removed. Use Content$bundle_download()
and Content$bundle_delete() instead.audit_vanity_urls() has been removed. To check if a vanity URL is in use,
use vanity_is_available() instead.audit_* functions have been modified to accept the result of get_content() rather than cache_apps() (which is now removed). They are faster as a result.tbl_connect(),
you will need to install dplyr and dbplyr explicitly. (#246)tbl_connect, rather than tbl_lazy,
preventing problems when also using dplyr (#177).progress is now an optional dependency. To show pretty progress bars, install
the package explicitly. (#269)Content$tag_delete() removes the tag from the target content item rather
than removing the tag entirely. (#194)audit_r_versions() returns a bar chart instead of a histogram (#179)NULL or length 1 job outputs (#193)RStudioConnect documentation is now at PositConnectpurrr deprecated changesmin_data_version parameter for usage data functions
(#166)set_vanity_url(), get_vanity_url(), swap_vanity_url()get_tags(), get_tag_data(), get_content_tags(), create_tag(),
create_tag_tree(), delete_tag(), get_content_tags(),
set_content_tags(), set_content_tag_tree(), filter_tag_tree_id(),
filter_tag_tree_chr(), set_environment_new(), get_environment(),
set_environment_remove(), download_bundle()tag ids are now character strings (of integers) instead of integersConnect$new() now takes a server argument (instead of host)
connect() function, although we warn about
argument deprecation in that case.
(#125)set_environment_new() and set_environment_remove() no longer
take a .version argument, and output data structure is a bit different (a
list of names). They now use the public API, which changes the interface a bit.
Also, intricacies of how to set / remove environment variables are changed (i.e.
setting VAR=NA will remove VAR).
(#141)get_vanity_url() and set_vanity_url() are now no longer
experimental functions.
(#113) However:
get_vanity_url() now returns a character string representing the vanity
url in use (or NULL if not defined)set_vanity_url() still returns a Vanity R6 object, but
vanity$get_vanity()$path_prefix is now vanity$get_vanity()$pathtag_page() and tag_page_iframe() have been removed. Similar functions belong
in the connectwidgets package in the future.content_* and other APIs have moved from experimental to
"v1" variants. This means they have stabilized, but with several subtle breaking
changes that could impact your scripts.
(#115)
bundle_id has become id in some response data. In others, url has become content_url.content$get_bundles() no longer takes a page_number
argument, and the get_bundles(limit) argument is now deprecated
(#129)Connect$download_bundle is now deprecated in favor of
Content$bundle_download(), and delete_bundle() now takes a Content
item instead of Connect.
(#153)acl_*() functions are deprecated in favor of
get_content_permissions(), content_add_user(), and friends.Connect$PUT(), Connect$POST() and Connect$PATCH() endpoints
now presume that an empty list is really a "map"/"object" (like {} instead
of []). This can break some endpoints that expect a list. Set
.empty_object=FALSE to avoid this behavior.users_create_remote() gains an exact argument to simplify complex cases
(#135). Long term, we should
solicit feedback on whether this function attempts to do too much.content_update(),
content_update_access_type() and content_update_owner()bundle_dir()
(@slodge)
(#118,
#121)overwrite= parameter to download_bundle()Task class to ContentTask
Task interface up-to-date on
ContentTask and VariantTask manuallycontent_list_* helpers
(#130):
content_list_with_permissions returns a content_list with a "permission"
column that includes who has accesscontent_list_by_tag allows fetching just a content_list for a particular tagcontent_list_guid_has_access filters a "content list with permission" by
whether a user or group GUID has accessuser_guid_from_username() function to convert session$user or other
usernames to a user GUID
(#130)client$PATCH verbContent$update() to use PATCH (which depends on RStudio Connect 1.8.6+)http/https is not definedBREAKING:
RSTUDIO_CONNECT_* variables to CONNECT_* variablesconnect$activate_bundle to connect$content_deployconnect$create_app to connect$content_createconnect$upload_bundle to connect$content_uploadconnect$get_users to connect$usersconnect$content_upload returns the response instead of bundle_idconnect$content_deploy returns the response instead of task_idapp_id to guidget_task$start renamed to get_task$firstpromote$app_name renamed to promote$nameconnectapiConnect object instead of server / api key
cache_appstag_pageOTHER:
contentaudit_logsserver_settingsserver_settings_rinst_shiny_usageinst_content_visitsswap_vanity_url, deployment functionsbrowse_ family of functionsusers_create_remote and groups_create_remote for remote users/groupsConnect R6 object to be compatible with Connect 1.7.0+ APIsNEWS.md file to track changes to the package.tbl_connect() as a lazy_tbl for querying Connect API endpointsget_* functions as alternatives to lazy_tblConnect R6 object