latestOpenAPI 3.0.02026-08-206790134.1 KB

8748e6c0be4c

Vercel

Upsert a Vercel Marketplace installation

Create or update an installation. Vercel sends this when a customer installs (or re-sends it idempotently). The acting account is taken from the signed token claims, not this body. There is one installation per Vercel team, and an installation can own many Xata organizations.

put/v1/installations/{installationId}

Path parameters

installationIdstring required

Vercel installation id (icfg_...).

Request body

scopesstring[] required

Scopes granted to the installation.

acceptedPoliciesobject required

Map of policy id to the acceptance timestamp (RFC 3339), e.g. {"toc": "2024-02-28T10:00:00Z"}.

Response

Installation created or updated. No body. (Vercel's contract also allows a 200 with an installation-level billingPlan/notification body; Xata does not use installation-level billing plans.)