| Field | Type | Required | Description |
|---|---|---|---|
projectReference | String! | Yes | Project UUID or slug. |
branch | String | No | Branch name or UUID, 1-255 characters without surrounding whitespace. Omit for main. |
specifiers | [String!]! | Yes | 1-100 npm specifiers to pin to exact versions in package.json after adding imports or packages. Each is 1-200 characters: bare package, exact version or semver range. |
expectedDeclarations | JSONObject | No | Observed package declarations: a map of npm package name to a string of up to 200 characters, or null when absent; at most 100 entries. Keys must equal the requested package names. Changed declarations are skipped. Declared as JSONObject so existing documents keep validating. |