LoginSign Up
← Back to all sparks
C

connectapi

INFRA · APIS
Velocity0.0

R client for the Posit Connect server API to automate content deployment

github.com/rstudio/connectapi ↗

connectapi is becoming the scripted administration surface for Posit Connect.

posit connectdeployment automationoauth integrationsapi clientdeprecation cycle
◆Current state
connectapi is the R client for the Posit Connect server API, covering content deployment, scheduling, usage data and permissions. Recent releases concentrate on OAuth integrations, which went from unmanaged to full CRUD in 0.9.0 and reached Connect Cloud in 0.12.0. Interleaved with that is steady removal of functions deprecated several versions back.
◆Where it's heading
Two directions run in parallel. The package is widening from a deployment client into an administration surface, through integrations, content search and content locking, which lets Connect configuration live in code rather than in the admin UI. At the same time it prunes aggressively: image helpers deprecated since 0.3.1 and job functions deprecated since 0.6.0 were both removed in this window, with set_schedule_*()'s activate argument on the same path. The result is a smaller but more capable API.
◆Prediction
The deprecation cycle is announced in advance, so the activate argument is the next likely removal. On the feature side, Connect Cloud support has so far landed only for OAuth and looks unfinished.

◆Recent moves

  1. 3mo ago

    Fix branch checks for newer Connect response format

    Adapts repo_check_branches() and its ref variant to a changed response shape in newer Connect versions. Routine server-tracking maintenance.

    View source ↗
  2. 4mo ago

    Connect Cloud apps supported for OAuth integrations

    Extends OAuth integrations to apps running on Connect Cloud via on_connect_cloud(), recognises POSIT_PRODUCT alongside RSTUDIO_PRODUCT, and reads the session token from a file so long-running processes can refresh credentials. The first substantial reach of the integrations work beyond Connect server.

    View source ↗
  3. 4mo ago

    get_usage() returns id as character

    Changes the get_usage() id column to character for consistency with the rest of the API surface. A one-line type correction.

    View source ↗
  4. 5mo ago

    get_usage() gains content_guid filter; image functions removed

    Adds server-side filtering of usage data by content GUID on Connect 2026.01 and later, improves page_cursor() performance, and removes seven image helpers deprecated since 0.3.1. Also deprecates the activate argument on set_schedule_*() after a Connect API change.

    View source ↗
  5. 6mo ago

    Deprecated get_job() and swap_vanity_url() removed

    Completes two deprecation cycles opened in 0.6.0, pointing users at the plural get_jobs()/get_job_list()/get_log() and swap_vanity_urls() replacements. Breaking, but long telegraphed.

    View source ↗
  6. 9mo ago

    Full OAuth integration management and content search added

    ⚡ SPARK

    The release that shifts connectapi from deploying content to administering the server, adding integration CRUD, content search and content locking. Everything since has extended this surface rather than the deployment one.

    View source ↗