Changelog

Source: NEWS.md

rstudioapi 0.18.0

CRAN release: 2026-01-16

• rstudioapi::documentNew() now accepts arbitrary document types. (#316)

• Added getIdentityToken() for retrieving the current user’s identity token on Posit Workbench, if possible.

• Added OAuth integration functions for Posit Workbench:

  • getOAuthIntegrations(): List all configured OAuth integrations.
  • getOAuthIntegration(): Get metadata for a specific integration by GUID.
  • findOAuthIntegration(): Search for integrations by name, display name, GUID, or authentication status, with regex support.
  • getOAuthCredentials(): Retrieve OAuth credentials for an integration.

• getDelegatedAzureToken() now works in any IDE running within a Posit Workbench session, not just RStudio.

• launcherSubmitJob() gains the resourceProfile argument.

rstudioapi 0.17.1

CRAN release: 2024-10-22

• Ensure a more appropriate error message is emitted for calls to rstudioapi::getVersion() and rstudioapi::getMode() outside of RStudio.

rstudioapi 0.17.0

CRAN release: 2024-10-16

• Added getMode(), which can be used to differentiate between Desktop and Server installations of RStudio. (#280)

rstudioapi 0.16.0

CRAN release: 2024-03-24

• restartSession() gains the clean argument, for RStudio 2024.04 and newer.

• Added setGhostText() for setting ghost text in the current editor.

rstudioapi 0.15.0

CRAN release: 2023-07-07

• Added getDelegatedAzureToken for Posit Workbench users needing to expose OAuth2 tokens for Azure services that have already had permissions configured

rstudioapi 0.14

CRAN release: 2022-08-22

• documentPath() now marks the encoding of file paths as UTF-8. (#257)

• getSourceEditorContext() gains the id argument, to be used to request the editor context for a document with an already-known ID. (#251)

• Added documentOpen(), for opening a document in RStudio and optionally navigating the cursor to a particular point in the file. The method is synchronous and returns the document ID upon completion.

• Fixed an issue where rstudioapi::askForSecret() would erroneously fall back to using rstudioapi::askForPassword() during Knit.

• Added registerCommandCallback, registerCommandStreamCallback, and unregisterCommandCallback, used to execute a callback after an IDE command is executed.

rstudioapi 0.13

CRAN release: 2020-11-12

• Fixed an issue where rstudioapi::insertText() would fail. (#208)

rstudioapi 0.12

CRAN release: 2020-11-10

• Fixed an issue where remote rstudioapi calls would erroneously use a previous response in some cases.

• Allow navigateToFile to accept an empty file. This file will default to the file currently in view in the active column.

• Added registerChunkExecCallback and unregisterChunkExecCallback, used to execute a callback after a chunk is ran.

rstudioapi 0.11

CRAN release: 2020-02-07

• rstudioapi::launcherResourceLimit() now properly delegates the type and memory arguments. (#164)

• rstudioapi gains the function highlightUi(), used to highlight UI elements in newer versions of RStudio.

• Paths returned from selectFile() are now properly marked with UTF-8 encoding.

• It is now possible for rstudioapi to communicate with a parent RStudio session, for R sessions launched as RStudio jobs. Use rstudioapi::isAvailable(child_ok = TRUE) to assert that it’s okay to check that rstudioapi is available and is running within an RStudio job.

• Added bugReport(), a helper function for reporting RStudio bugs on the GitHub issue tracker with an issue template pre-populated with some helpful diagnostic information.

• Added userIdentity and systemUsername, used to retrieve information about the current user.

rstudioapi 0.10

CRAN release: 2019-03-19

• Added the parameters echo and focus to sendToConsole().

rstudioapi 0.9

• Added functions for displaying jobs in RStudio’s Jobs pane: jobAdd(), jobRemove(), etc.

• Added translateLocalUrl(), for translating localhost URLs to externally addressable ones on RStudio Server.

rstudioapi 0.8

CRAN release: 2018-10-02

• Added functions for installing + using build tools: buildToolsCheck(), buildToolsInstall(), buildToolsExec()

• Added functions for installing + using themes: addTheme(), applyTheme(), convertTheme(), getThemes(), getThemeInfo().

• Added previewSql(), for previewing output from executing a SQL query.

• Added askForSecret(), for prompting the user to enter a password or otherwise privileged information.

• Fixed an issue where getActiveProject() failed for non-ASCII paths. (#86)

rstudioapi 0.7

CRAN release: 2017-09-07

• Added methods for prompting the user for file paths: selectFile(), selectDirectory().

• askForPassword() gains a default prompt (#41)

• Add createProjectTemplate() function

• Add setPersistentValue() / getPersistentValue() functions

• Add methods for interacting with Terminal tab: terminalActivate(), terminalClear(), terminalCreate(), terminalList(), terminalBuffer(), terminalContext(), terminalVisible(), terminalBusy(), terminalRunning(), terminalKill(), terminalSend(), terminalExecute(), and terminalExitCode().

rstudioapi 0.6

CRAN release: 2016-06-27

• Add sendToConsole function

• Add APIs for setting cursor position in document

rstudioapi 0.5

CRAN release: 2016-01-24

• Add askForPassword function

• Add getActiveProject function

rstudioapi 0.4

• Add API methods for interacting with a document open in RStudio: ‘insertText()’, ‘modifyRange()’ and ‘getActiveDocumentContext()’.

rstudioapi 0.3

• Add stub and documentation for sourceMarker function

rstudioapi 0.2

CRAN release: 2014-12-31

• Compatibility with calling conventions for RStudio v0.99

• Stubs and documentation for versionInfo, previewRd, and viewer functions

rstudioapi 0.1

CRAN release: 2014-03-27

• Initial release to CRAN