token_fetch: Fetch a token for the given scopes

View source: R/token-fetch.R

token_fetchR Documentation

Fetch a token for the given scopes


This is a rather magical function that calls a series of concrete credential-fetching functions, each wrapped in a tryCatch(). token_fetch() keeps trying until it succeeds or there are no more functions to try. Use cred_funs_list() to see the current registry, in order. See the vignette How gargle gets tokens for a full description of token_fetch().


token_fetch(scopes = NULL, ...)



A character vector of scopes to request. Pick from those listed at

For certain token flows, the "" scope is unconditionally included. This grants permission to retrieve the email address associated with a token; gargle uses this to index cached OAuth tokens. This grants no permission to view or send email and is generally considered a low-value scope.


Additional arguments passed to all credential functions.


An httr::Token or NULL.

See Also

Other credential functions: credentials_app_default(), credentials_byo_oauth2(), credentials_external_account(), credentials_gce(), credentials_service_account(), credentials_user_oauth2()


## Not run: 
token_fetch(scopes = "")

## End(Not run)

gargle documentation built on Sept. 8, 2022, 9:07 a.m.