http_config: HTTP Remote Launch Configuration

In mirai: Minimalist Async Evaluation Framework for R

HTTP Remote Launch Configuration

Description

Generates a remote configuration for launching daemons via HTTP API. By default, automatically configures for Posit Workbench using environment variables.

Usage

http_config(
  url = posit_workbench_url,
  method = "POST",
  cookie = posit_workbench_cookie,
  token = NULL,
  data = posit_workbench_data
)

Arguments

url	(character or function) URL endpoint for the launch API. May be a function returning the URL value.
method	(character) HTTP method, typically "POST".
cookie	(character or function) session cookie value. May be a function returning the cookie value. Set to NULL if not required for authentication.
token	(character or function) authentication bearer token. May be a function returning the token value. Set to NULL if not required for authentication.
data	(character or function) JSON or formatted request body containing the daemon launch command. May be a function returning the data value. Should include a placeholder "%s" where the mirai::daemon() call will be inserted at launch time.

Value

A list in the required format to be supplied to the remote argument of daemons() or launch_remote().

See Also

ssh_config(), cluster_config() and remote_config() for other types of remote configuration.

Examples

tryCatch(http_config(), error = identity)

# Custom HTTP configuration example:
http_config(
  url = "https://api.example.com/launch",
  method = "POST",
  cookie = function() Sys.getenv("MY_SESSION_COOKIE"),
  token = function() Sys.getenv("MY_API_KEY"),
  data = '{"command": "%s"}'
)

## Not run: 
# Launch 2 daemons using http config default (for Posit Workbench):
daemons(n = 2, url = host_url(), remote = http_config())

## End(Not run)

mirai documentation built on Feb. 13, 2026, 9:07 a.m.