Skip to main content
POST
Install a package from its address

Authorizations

Authorization
string
header
required

A pc_… token generated from Settings > API & MCP.

Body

application/json
acceptedDigest
string | null
required

The content digest of the preview whose permissions were accepted — required, because an install with nothing to compare against is an install nobody consented to. Send null only when the preview showed none, which is what a version frozen before digests existed reports. Anything other than an exact match with the version on offer is refused with 409 rather than quietly installing something else.

Required string length: 64
packageId
string<uuid>

From a package already granted to you.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
token
string

From a share link.

Required string length: 1 - 128

Response

Created.

install
object
required
files
object[]
required
alreadyInstalled
boolean
required