Content: Content

In connectapi: Utilities for Interacting with the 'Posit Connect' Server API

Content

Description

Content

Content

Details

An R6 class that represents content.

Public fields

connect

An R6 Connect object.

content

The content details from Posit Connect. Properties are described in get_content().

Active bindings

default_variant

The default variant for this object.

is_rendered

TRUE if this is a rendered content type, otherwise FALSE.

is_interactive

TRUE if this is a rendered content type, otherwise FALSE.

Methods

Public methods

• Content$new()

• Content$get_content_remote()

• Content$get_bundles()

• Content$bundle_download()

• Content$bundle_delete()

• Content$update()

• Content$danger_delete()

• Content$get_url()

• Content$get_dashboard_url()

• Content$jobs()

• Content$job()

• Content$register_job_kill_order()

• Content$variants()

• Content$tag_set()

• Content$tag_delete()

• Content$tags()

• Content$permissions_add()

• Content$permissions_update()

• Content$permissions_delete()

• Content$permissions()

• Content$environment()

• Content$environment_set()

• Content$environment_all()

• Content$deploy()

• Content$repository()

• Content$repo_enable()

• Content$repo_set()

• Content$packages()

• Content$print()

• Content$clone()

---

Method new()

Initialize this content.

Usage

Content$new(connect, content)

Arguments

connect

The Connect instance.

content

The content data.

---

Method get_content_remote()

Obtain the content data from the Connect server.

Usage

Content$get_content_remote()

---

Method get_bundles()

Return the set of content bundles.

Usage

Content$get_bundles()

---

Method bundle_download()

Download the source archive for a content bundle.

Usage

Content$bundle_download(
  bundle_id,
  filename = tempfile(pattern = "bundle", fileext = ".tar.gz"),
  overwrite = FALSE
)

Arguments

bundle_id

The bundle identifer.

filename

Where to write the result.

overwrite

Overwrite an existing filename.

---

Method bundle_delete()

Delete a content bundle.

Usage

Content$bundle_delete(bundle_id)

Arguments

bundle_id

The bundle identifer.

---

Method update()

Update this content item.

Usage

Content$update(...)

Arguments

...

Content fields.

---

Method danger_delete()

Delete this content item.

Usage

Content$danger_delete()

---

Method get_url()

Return the URL for this content.

Usage

Content$get_url()

---

Method get_dashboard_url()

Return the URL for this content in the Posit Connect dashboard.

Usage

Content$get_dashboard_url(pane = "")

Arguments

pane

The pane in the dashboard to link to.

---

Method jobs()

Return the jobs for this content

Usage

Content$jobs()

---

Method job()

Return a single job for this content.

Usage

Content$job(key)

Arguments

key

The job key.

---

Method register_job_kill_order()

Terminate a single job for this content item.

Usage

Content$register_job_kill_order(key)

Arguments

key

The job key.

---

Method variants()

Return the variants for this content.

Usage

Content$variants()

---

Method tag_set()

Set a tag for this content.

Usage

Content$tag_set(tag_id)

Arguments

tag_id

The tag identifier.

---

Method tag_delete()

Remove a tag for this content.

Usage

Content$tag_delete(tag_id)

Arguments

tag_id

The tag identifier.

---

Method tags()

The tags for this content.

Usage

Content$tags()

---

Method permissions_add()

Add a principal to the ACL for this content.

Usage

Content$permissions_add(principal_guid, principal_type, role)

Arguments

principal_guid

GUID for the target user or group.

principal_type

Acting on user or group.

role

The kind of content access.

---

Method permissions_update()

Alter a principal in the ACL for this content.

Usage

Content$permissions_update(id, principal_guid, principal_type, role)

Arguments

id

The target identifier.

principal_guid

GUID for the target user or group.

principal_type

Acting on user or group.

role

The kind of content access.

---

Method permissions_delete()

Remove an entry from the ACL for this content.

Usage

Content$permissions_delete(id)

Arguments

id

The target identifier.

---

Method permissions()

Obtain some or all of the ACL for this content.

Usage

Content$permissions(id = NULL, add_owner = FALSE)

Arguments

id

The target identifier.

add_owner

Include the content owner in the result set.

---

Method environment()

Return the environment variables set for this content.

Usage

Content$environment()

---

Method environment_set()

Adjust the environment variables set for this content.

Usage

Content$environment_set(...)

Arguments

...

Environment variable names and values. Use NA as the value to unset variables.

---

Method environment_all()

Overwrite the environment variables set for this content.

Usage

Content$environment_all(...)

Arguments

...

Environment variable names and values.

---

Method deploy()

Deploy this content

Usage

Content$deploy(bundle_id = NULL)

Arguments

bundle_id

Target bundle identifier.

---

Method repository()

Get Git repository details

Usage

Content$repository()

Returns

NULL if no repo is set, otherwise a list with fields:

• repository

• branch

• directory

• polling

• last_error

• last_known_commit

---

Method repo_enable()

Adjust Git polling.

Usage

Content$repo_enable(polling = TRUE)

Arguments

polling

Polling enabled.

---

Method repo_set()

Adjust Git repository

Usage

Content$repo_set(repository, branch = "main", directory = ".", polling = FALSE)

Arguments

repository

Git repository URL

branch

Git repository branch

directory

Git repository directory

polling

Whether to check for updates

---

Method packages()

Get package dependencies

Usage

Content$packages()

---

Method print()

Print this object.

Usage

Content$print(...)

Arguments

...

Unused.

---

Method clone()

The objects of this class are cloneable with this method.

Usage

Content$clone(deep = FALSE)

Arguments

deep

Whether to make a deep clone.

See Also

Other R6 classes: Bundle, ContentTask, Environment, PositConnect, Task, Vanity, Variant, VariantSchedule, VariantTask

connectapi documentation built on Nov. 5, 2025, 7:32 p.m.