---
id: package-installation-create
title: Install a package
description: >-
  Install a package at an NRN. The installation sets where in your organization
  the package's specification can be used (`visible_to`) and which revision new
  services and scopes are created with (`default_revision_id`). Nothing is
  copied: the specification, its actions and its links stay the publisher's.
sidebar_label: Install a package
hide_title: true
hide_table_of_contents: true
api: >-
  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
sidebar_class_name: post api-method
info_path: docs/api/package
custom_edit_url: null
canonical: 'https://docs.nullplatform.com/docs/api/package-installation-create'
---
<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Install a package"}
>
</Heading>

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

</MethodEndpoint>

Install a package at an NRN. The installation sets where in your organization the package's specification can be used (`visible_to`) and which revision new services and scopes are created with (`default_revision_id`). Nothing is copied: the specification, its actions and its links stay the publisher's.

You can install a global package or one your organization owns, and you need read access to the package.

When you omit `default_revision_id`, the package's default revision is resolved at that moment and stored. If the package has no default, its latest revision is used. The installation stays on that revision until you move it: a new release of the package doesn't change it.

> ℹ️ **Note:** The request fails with `400` when the package belongs to another organization and isn't global, when the revision is deprecated or belongs to another package, or when a `visible_to` entry is outside your organization. It fails with `409` when the package is already installed at that NRN.

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

<ParamsDetails
  parameters={undefined}
>

</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["nrn","package_id"],"properties":{"nrn":{"type":"string","description":"The NRN to install the package at: an organization, account, namespace or application.","example":"organization=1:account=2"},"package_id":{"type":"string","format":"uuid","description":"The package to install: 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 are created with. When omitted, the package's default revision is resolved once and stored, or its latest revision when the package has no default.","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: these NRNs and everything below them. Defaults to [nrn]. Every entry must belong to the same organization as nrn.","example":["organization=1:account=2"]}},"title":"packageInstallationCreate"}}}}}
>

</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"201":{"description":"The 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"}}}},"409":{"description":"The package is already installed at that NRN.","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"}}}},"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>

