---
id: package-installation-update
title: Update a package installation
description: >-
  Move the installation to another revision, change where it's visible, or both.
  Send at least one of `default_revision_id` or `visible_to`.
sidebar_label: Update a package installation
hide_title: true
hide_table_of_contents: true
api: >-
  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
sidebar_class_name: patch api-method
info_path: docs/api/package
custom_edit_url: null
canonical: 'https://docs.nullplatform.com/docs/api/package-installation-update'
---
<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Update a package installation"}
>
</Heading>

<MethodEndpoint
  method={"patch"}
  path={"/package_installations/{id}"}
  context={"endpoint"}
>

</MethodEndpoint>

Move the installation to another revision, change where it's visible, or both. Send at least one of `default_revision_id` or `visible_to`.

Moving `default_revision_id` changes the revision new services and scopes are created with. The ones that already exist keep running theirs until you set a desired revision on them.

> ℹ️ **Note:** The request fails with `400` when the revision is deprecated or belongs to another package, or when a `visible_to` entry is outside your organization.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"},"description":"The installation id.","example":"7d8e9f0a-1b2c-4d3e-9f4a-5b6c7d8e9f0a"}]}
>

</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"required":true,"content":{"application/json":{"schema":{"type":"object","minProperties":1,"properties":{"default_revision_id":{"type":"string","format":"uuid","description":"The revision new services and scopes are created with from now on. It must belong to the installed package and can't be deprecated.","example":"e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b"},"visible_to":{"type":"array","items":{"type":"string"},"description":"Where inside the organization the package's specification is visible and usable. Every entry must belong to the same organization as the installation's nrn.","example":["organization=1:account=2"]}},"title":"packageInstallationUpdate"}}}}}
>

</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The updated installation.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The installation id.","example":"7d8e9f0a-1b2c-4d3e-9f4a-5b6c7d8e9f0a"},"nrn":{"type":"string","description":"The NRN the package is installed at. It owns the installation.","example":"organization=1:account=2"},"package_id":{"type":"string","format":"uuid","description":"The installed package: a global one, or one your organization owns.","example":"1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"},"default_revision_id":{"type":"string","format":"uuid","description":"The revision new services and scopes under `visible_to` are created with.","example":"e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b"},"default_version":{"type":"string","nullable":true,"description":"Server-derived semver of default_revision_id.","example":"1.4.0"},"visible_to":{"type":"array","items":{"type":"string"},"description":"Where inside the organization the package's specification is visible and usable: these NRNs and everything below them.","example":["organization=1:account=2"]},"created_by":{"type":"string","nullable":true,"description":"The user who installed the package, or null.","example":"jane.doe@example.com"},"created_at":{"type":"string","format":"date-time","description":"When the package was installed.","example":"2026-09-14T12:00:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"When the installation last changed.","example":"2026-09-14T12:00:00.000Z"}},"title":"packageInstallation"}}}},"4XX":{"description":"Client error responses due to invalid input, missing parameters or insufficient permissions.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","example":400},"code":{"type":"string","example":"bad_request"},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","description":"Human-readable explanation.","example":"Revision '1.4.0' exists with a different bill of materials (revision e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b)"}},"title":"errorResponse"}}}},"5XX":{"description":"Server error responses.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","example":400},"code":{"type":"string","example":"bad_request"},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","description":"Human-readable explanation.","example":"Revision '1.4.0' exists with a different bill of materials (revision e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b)"}},"title":"errorResponse"}}}}}}
>

</StatusCodes>

