Skip to main content
Documentation

Repositories

Actions in the repositories namespace of the Nexigon Hub API.

Badges mark actions of the Device API and the Admin API, whose compatibility differs from other actions.

repositories_ResolveName

POST/api/v1/actions/invoke/repositories_ResolveName

Resolve a repository by its name.

Within an organization, the repository is given by its path name. The organization defaults to that of the request, which is set by an organization API token, the X-Nexigon-Organization header, or the project of a device. Without an organization, the repository is given by its slug. A repository ID resolves in both cases.

Request ResolveRepositoryNameAction

  • organizationIdstringOrganizationIdoptional

    Organization to resolve path names in.

    Defaults to the organization of the request. See the action for details.

  • repositorystring

    Path name, slug, or ID of the repository.

    • Repository name must be between 1 and 128 characters.
    • Repository name must start with a letter or digit and contain only letters, digits, dots, underscores, or hyphens.

Response ResolveRepositoryNameOutput

One of the following, identified by result:

  • result: "Found"

    The repository has been found.

    • repositoryIdstringRepositoryId
  • result: "NotFound"

    The repository has not been found.

    This may also be returned if the actor does not have the necessary permissions.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"repository":"<repository>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_ResolveName
{
  "result": "Found",
  "repositoryId": "<repository-id>"
}

repositories_GetDetails

POST/api/v1/actions/invoke/repositories_GetDetails

Get information about a repository.

Request GetRepositoryDetailsAction

  • repositoryIdstringRepositoryId

    ID of the repository.

Response GetRepositoryDetailsOutput

  • repositoryIdstringRepositoryId

    ID of the repository.

  • displayNamestring

    Display name of the repository.

  • pathNamestringoptional

    Path name of the repository, unique within its organization.

    Absent on older Hub versions.

  • slugstringoptional

    Slug of the repository, unique on the instance, if one has been set.

  • publicNamestring
    • Deprecated — removed in 2029.2 — Use slug, which is absent when no slug is set.

    Public name of the repository.

    Falls back to the repository ID when no slug is set.

  • visibilitystringRepositoryVisibility

    Visibility of the repository.

    • "Public"

      The repository is public and can be accessed by anyone.

    • "Private"

      The repository is private and can only be accessed by its members.

  • packageCountinteger (64-bit)

    Number of packages in the repository.

  • assetCountinteger (64-bit)

    Number of assets in the repository.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"repositoryId":"<repository-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_GetDetails
{
  "repositoryId": "<repository-id>",
  "displayName": "<display-name>",
  "publicName": "<public-name>",
  "visibility": "Public",
  "packageCount": 1,
  "assetCount": 1
}

repositories_Create

POST/api/v1/actions/invoke/repositories_Create

Create a new repository.

Request CreateRepositoryAction

  • organizationIdstringOrganizationId

    Organization to create the repository in.

  • displayNamestring

    Display name of the repository.

    Free-form, human-facing name.

    • Display name must be between 1 and 128 characters.
  • pathNamestringoptional

    Path name of the repository, unique within the organization.

    Defaults to default, with a numeric suffix such as default-2 if it is already taken.

    • Path name must be between 1 and 128 characters.
    • Path name must start with a letter or digit and contain only letters, digits, dots, underscores, or hyphens.
  • visibilitystringRepositoryVisibilityoptional

    Visibility of the repository.

    Default to private.

    • "Public"

      The repository is public and can be accessed by anyone.

    • "Private"

      The repository is private and can only be accessed by its members.

Response CreateRepositoryOutput

One of the following, identified by result:

  • result: "NameAlreadyExists"

    A repository with the same path name already exists in the organization.

  • result: "Created"

    The repository has been created.

    • repositoryIdstringRepositoryId

      ID of the repository.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "organizationId": "<organization-id>",
    "displayName": "<display-name>"
  }' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_Create
{
  "result": "Created",
  "repositoryId": "<repository-id>"
}

repositories_Delete

POST/api/v1/actions/invoke/repositories_Delete

Delete a repository with all of its packages and versions, also sealed versions and releases.

Request DeleteRepositoryAction

  • repositoryIdstringRepositoryId

    ID of the repository.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"repositoryId":"<repository-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_Delete
{}

repositories_SetVisibility

POST/api/v1/actions/invoke/repositories_SetVisibility

Set the visibility of a repository.

Request SetRepositoryVisibilityAction

  • repositoryIdstringRepositoryId

    ID of the repository.

  • visibilitystringRepositoryVisibility

    New visibility of the repository.

    • "Public"

      The repository is public and can be accessed by anyone.

    • "Private"

      The repository is private and can only be accessed by its members.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"repositoryId":"<repository-id>","visibility":"Public"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SetVisibility
{}

repositories_SetDisplayName

POST/api/v1/actions/invoke/repositories_SetDisplayName

Set the display name of a repository.

Request SetRepositoryDisplayNameAction

  • repositoryIdstringRepositoryId

    ID of the repository.

  • displayNamestring

    New display name of the repository.

    • Display name must be between 1 and 128 characters.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "repositoryId": "<repository-id>",
    "displayName": "<display-name>"
  }' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SetDisplayName
{}

repositories_SetPathName

POST/api/v1/actions/invoke/repositories_SetPathName

Set the path name of a repository.

Paths that use the previous path name no longer resolve.

Request SetRepositoryPathNameAction

  • repositoryIdstringRepositoryId

    ID of the repository.

  • pathNamestring

    New path name of the repository.

    • Path name must be between 1 and 128 characters.
    • Path name must start with a letter or digit and contain only letters, digits, dots, underscores, or hyphens.

Response SetRepositoryPathNameOutput

One of the following, identified by result:

  • result: "NameAlreadyExists"

    A repository with the same path name already exists in the organization.

  • result: "Success"

    The path name has been set.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"repositoryId":"<repository-id>","pathName":"<path-name>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SetPathName
{
  "result": "NameAlreadyExists"
}

repositories_SetSlug

POST/api/v1/actions/invoke/repositories_SetSlug

Set the slug of a repository.

The slug is unique on the instance. It addresses the repository in paths resolved without an organization, for example, by anonymous clients of a public repository.

Note: Setting the slug requires the public_repositories subscription feature.

Request SetRepositorySlugAction

  • repositoryIdstringRepositoryId

    ID of the repository.

  • slugstring

    New slug of the repository.

    • Repository slug must be between 1 and 128 characters.
    • Repository slug must start with a letter or digit and contain only letters, digits, dots, underscores, or hyphens.

Response SetRepositorySlugOutput

One of the following, identified by result:

  • result: "SlugAlreadyExists"

    A repository with the same slug already exists.

  • result: "Success"

    The slug has been set.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"repositoryId":"<repository-id>","slug":"<slug>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SetSlug
{
  "result": "SlugAlreadyExists"
}

repositories_QueryPackages

POST/api/v1/actions/invoke/repositories_QueryPackages

Query the packages of a repository.

Request QueryRepositoryPackagesAction

  • repositoryIdstringRepositoryId

    ID of the repository.

Response QueryRepositoryPackagesOutput

  • packagesarray<object>QueryRepositoryPackagesItem

    List of packages.

    9 fields
    • displayNamestringoptional

      Human-readable name, falling back to name when absent.

    • packageIdstringPackageId

      ID of the package.

    • namestring

      Name of the package.

    • kindstringoptional

      Kind of the package (e.g., "rugix-app").

    • createdAtstring (date-time)Timestamp

      Timestamp when the package was created.

    • descriptionstringoptional

      CommonMark description. Absent when not set or on older Hub versions.

    • imageUrlstringoptional

      Root-relative URL for the PNG on this Hub. Absent when no image is set.

    • versionCountinteger (64-bit)optional

      Number of versions of the package. Absent on older Hub versions.

    • latestVersionobjectQueryPackageVersionsItemoptional

      Most recently created version. Absent when the package has no versions or on older Hub versions.

      11 fields
      • versionIdstringPackageVersionId

        ID of the package version.

      • namestringoptional

        Optional name of the version.

      • createdAtstring (date-time)Timestamp

        Timestamp when the package version was created.

      • deleteAtstring (date-time)Timestampoptional

        Explicit deletion deadline. Package retention can delete the version earlier.

      • sealedbooleanoptional

        Sealed versions reject content changes and deletion, except by deleting their repository. Absent on older Hub versions.

      • releasebooleanoptional

        Releases are retained indefinitely. Independent of sealing. Absent on older Hub versions.

      • tagsarray<object>PackageVersionTag

        Tags of the package version.

        3 fields
        • tagstring

          Tag of the package version.

        • lockedboolean

          Indicates whether the tag is locked.

        • assignedAtstring (date-time)Timestampoptional

          Time at which the tag was assigned to the version. Absent on older Hub versions.

      • baseVersionIdstringPackageVersionIdoptional

        Version that a device must run before installing this version.

      • baseVersionNamestringoptional

        Optional name of the base version.

      • assetCountinteger (64-bit)optional

        Number of assets of the version. Absent on older Hub versions.

      • assetSizeinteger (64-bit)optional

        Total size of the version's assets in bytes. Absent on older Hub versions.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"repositoryId":"<repository-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_QueryPackages
{
  "packages": [
    {
      "packageId": "<package-id>",
      "name": "<name>",
      "createdAt": "2026-01-01T12:00:00Z"
    }
  ]
}

repositories_QueryAssets

POST/api/v1/actions/invoke/repositories_QueryAssets

Query the assets of a repository.

Request QueryRepositoryAssetsAction

  • repositoryIdstringRepositoryId

    ID of the repository.

  • pageobjectPageRequestoptional

    Bounded cursor page. Omission preserves the legacy unbounded response.

    2 fields
    • limitintegeroptional

      Maximum number of items. The default depends on the endpoint and the ceiling is configured by the Hub operator (1000 by default).

      • Page limit must be positive.
    • cursorstringPageCursoroptional

      Continue the same endpoint, scope, filters, and ordering.

  • filterstringRepositoryAssetFilteroptional

    Defaults to all assets. Totals always cover the whole repository.

    • "All"
    • "Unused"
    • "Issues"
  • sortstringRepositoryAssetSortoptional

    Defaults to largest first for pages, creation order for legacy requests.

    • "Largest"
    • "CleanupDate"

Response QueryRepositoryAssetsOutput

  • assetsarray<object>QueryRepositoryAssetsItem

    List of assets.

    5 fields
    • lifecycleobjectRepositoryAssetLifecycleoptional

      Reference count and cleanup status. Absent on older Hubs.

      5 fields
      • referenceCountinteger (64-bit)
      • unreferencedSincestring (date-time)Timestampoptional
      • eligibleAtstring (date-time)Timestampoptional

        Earliest automatic deletion time; absent while cleanup is disabled or referenced.

      • deletionStartedAtstring (date-time)Timestampoptional
      • deletionErrorstringoptional

        Sanitized reason for the latest cleanup failure.

    • assetIdstringRepositoryAssetId

      ID of the asset.

    • sizeinteger (64-bit)

      Size of the asset.

    • digeststringDigest

      Digest of the asset.

    • storageobjectRepositoryAssetStorageoptional

      Latest storage check. Absent when connected to an older Hub.

      3 fields
      • statusstringRepositoryAssetStorageStatus
        • "Unknown"

          The asset has not been checked yet.

        • "Present"

          A legacy object exists with the expected size, but has no verifiable checksum metadata.

        • "Verified"

          The object carries matching size, checksum, digest, and ownership metadata.

        • "Missing"

          No object exists at the expected key.

        • "Mismatched"

          The object exists but its size or verification metadata does not match.

        • "Error"

          The storage provider could not be checked.

      • checkedAtstring (date-time)Timestampoptional
      • detailstringoptional
  • usageobjectRepositoryAssetUsageoptional

    Repository-wide storage totals. Absent on older Hubs.

    8 fields
    • assetCountinteger (64-bit)
    • storedBytesinteger (64-bit)

      Bytes of objects last observed present or verified, including pending deletions.

    • referencedBytesinteger (64-bit)

      Stored bytes with at least one package or version attachment.

    • unusedBytesinteger (64-bit)

      Stored bytes without package or version attachments.

    • unconfirmedBytesinteger (64-bit)

      Declared bytes whose presence is unknown, missing, or inconsistent.

    • unconfirmedCountinteger (64-bit)

      Number of assets with unknown, missing, inconsistent, or failed storage checks.

    • cleanupErrorCountinteger (64-bit)

      Number of assets with a failed deletion attempt.

    • checkedAtstring (date-time)Timestampoptional

      Oldest storage observation among stored assets.

  • cleanupobjectRepositoryAssetCleanupSettingsoptional

    Automatic cleanup policy. Absent on older Hubs.

    3 fields
    • enabledboolean
    • graceDaysinteger

      Whole days without package references before automatic deletion.

    • enabledAtstring (date-time)Timestampoptional

      Most recent enablement. Existing unused assets receive a full grace period.

  • pageobjectPageInfooptional

    Continuation for a requested page. Absent for legacy requests.

    1 field
    • nextCursorstringPageCursoroptional

      Cursor for the next page; absent when no more matching rows were visible.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"repositoryId":"<repository-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_QueryAssets
{
  "assets": [
    {
      "assetId": "<repository-asset-id>",
      "size": 1,
      "digest": "<digest>"
    }
  ]
}

repositories_SetAssetCleanup

POST/api/v1/actions/invoke/repositories_SetAssetCleanup

Configure automatic cleanup. Requires permission to manage repository settings.

Request SetRepositoryAssetCleanupAction

  • repositoryIdstringRepositoryId
  • enabledboolean
  • graceDaysinteger
    • Grace period must be at least one day.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "repositoryId": "<repository-id>",
    "enabled": true,
    "graceDays": 1
  }' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SetAssetCleanup
{}

repositories_GetAssetReferences

POST/api/v1/actions/invoke/repositories_GetAssetReferences

List the package attachments retaining a repository asset.

Request GetAssetReferencesAction

  • assetIdstringRepositoryAssetId
  • pageobjectPageRequestoptional

    Bounded cursor page. Omission preserves the legacy unbounded response.

    2 fields
    • limitintegeroptional

      Maximum number of items. The default depends on the endpoint and the ceiling is configured by the Hub operator (1000 by default).

      • Page limit must be positive.
    • cursorstringPageCursoroptional

      Continue the same endpoint, scope, filters, and ordering.

Response GetAssetReferencesOutput

  • referencesarray<object>RepositoryAssetReference
    5 fields
    • packageIdstringPackageId
    • packageNamestring
    • versionIdstringPackageVersionIdoptional

      Absent for a package-level attachment.

    • versionNamestringoptional
    • filenamestring
  • pageobjectPageInfooptional

    Package attachments precede version attachments, each in stable ID order.

    1 field
    • nextCursorstringPageCursoroptional

      Cursor for the next page; absent when no more matching rows were visible.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"assetId":"<repository-asset-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_GetAssetReferences
{
  "references": [
    {
      "packageId": "<package-id>",
      "packageName": "<package-name>",
      "filename": "<filename>"
    }
  ]
}

repositories_QueryLinkedProjects

POST/api/v1/actions/invoke/repositories_QueryLinkedProjects

Query repository projects.

Request QueryRepositoryProjectsAction

  • repositoryIdstringRepositoryId

    ID of the repository.

Response QueryRepositoryProjectsOutput

  • projectsarray<object>QueryRepositoryProjectsItem

    List of projects.

    2 fields
    • projectIdstringProjectId

      ID of the project.

    • namestring

      Name of the project.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"repositoryId":"<repository-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_QueryLinkedProjects
{
  "projects": [
    {
      "projectId": "<project-id>",
      "name": "<name>"
    }
  ]
}

repositories_ResolvePackageByPath

POST/api/v1/actions/invoke/repositories_ResolvePackageByPath

Resolve a package by its path.

Within an organization, the repository is given by its path name. The organization defaults to that of the request, which is set by an organization API token, the X-Nexigon-Organization header, or the project of a device. Without an organization, the repository is given by its slug. A repository ID resolves in both cases.

Request ResolvePackageByPathAction

  • organizationIdstringOrganizationIdoptional

    Organization to resolve path names in.

    Defaults to the organization of the request. See the action for details.

  • repositorystring

    Path name, slug, or ID of the repository.

    • Repository name must be between 1 and 128 characters.
    • Repository name must start with a letter or digit and contain only letters, digits, dots, underscores, or hyphens.
  • packagestring

    Name or ID of the package.

    • Package name must be between 1 and 128 characters.
    • Package name must start with a letter or digit and contain only letters, digits, dots, underscores, or hyphens.

Response ResolvePackageByPathOutput

One of the following, identified by result:

  • result: "Found"

    The package has been found.

    • repositoryIdstringRepositoryId

      ID of the repository.

    • packageIdstringPackageId

      ID of the package.

  • result: "NotFound"

    The package has not been found.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"repository":"<repository>","package":"<package>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_ResolvePackageByPath
{
  "result": "Found",
  "repositoryId": "<repository-id>",
  "packageId": "<package-id>"
}

repositories_GetPackageDetails

POST/api/v1/actions/invoke/repositories_GetPackageDetails

Get information about a package.

Request GetPackageDetailsAction

  • packageIdstringPackageId

    ID of the package.

Response GetPackageDetailsOutput

  • presentationobjectPackagePresentationoptional

    Optional display information. Absent on older Hub versions.

    3 fields
    • displayNamestringoptional

      Human-readable name. Absent when the URL-safe package name is used.

    • descriptionstringoptional

      CommonMark description. Raw HTML is not rendered by the Hub UI.

    • imageUrlstringoptional

      Root-relative URL for the PNG on this Hub. Absent when no image is set. Fetch with the same credentials as package details. Supports ETag validation.

  • imageLimitsobjectPackageImageLimitsoptional

    Image upload limits configured by this Hub. Absent on older Hub versions.

    2 fields
    • maxBytesinteger

      Maximum decoded file size in bytes.

    • maxDimensioninteger

      Maximum width and height in pixels.

  • packageIdstringPackageId

    ID of the package.

  • namestring

    Name of the package.

  • kindstringoptional

    Kind of the package (e.g., "rugix-app").

  • versionCountinteger (64-bit)

    Number of versions of the package.

  • retentionobjectPackageVersionRetentionoptional

    Package retention policy. Absent on older Hub versions.

    3 fields
    • enabledboolean
    • maxVersionsintegeroptional

      Maximum number of newest eligible versions to keep. Protected versions do not count.

      • Version count must be a positive integer.
    • maxAgeDaysintegeroptional

      Maximum age in fixed 24-hour days. This can expire every eligible version.

      • Maximum age must be a positive number of days.
  • metadatamap<string, any>JsonValue

    Package-level metadata.

  • assetsarray<object>PackageAsset

    Assets attached to the package itself (independent of versions). Used by the package-level VEX flow but generic — anything that wants to live on the package can be attached here.

    7 fields
    • assetIdstringRepositoryAssetId
    • filenamestring
    • sizeinteger (64-bit)
    • digeststringDigest
    • statusstringRepositoryAssetStatus
      • "Dangling"

        The asset has been created but not yet uploaded.

      • "Available"

        The asset has been uploaded and is available.

      • "Deleting"

        The asset is in the process of being deleted.

    • storageobjectRepositoryAssetStorageoptional

      Latest storage check. Absent when connected to an older Hub.

      3 fields
      • statusstringRepositoryAssetStorageStatus
        • "Unknown"

          The asset has not been checked yet.

        • "Present"

          A legacy object exists with the expected size, but has no verifiable checksum metadata.

        • "Verified"

          The object carries matching size, checksum, digest, and ownership metadata.

        • "Missing"

          No object exists at the expected key.

        • "Mismatched"

          The object exists but its size or verification metadata does not match.

        • "Error"

          The storage provider could not be checked.

      • checkedAtstring (date-time)Timestampoptional
      • detailstringoptional
    • metadatamap<string, any>JsonValue

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"packageId":"<package-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_GetPackageDetails
{
  "packageId": "<package-id>",
  "name": "<name>",
  "versionCount": 1,
  "metadata": {
    "<key>": {}
  },
  "assets": [
    {
      "assetId": "<repository-asset-id>",
      "filename": "<filename>",
      "size": 1,
      "digest": "<digest>",
      "status": "Dangling",
      "metadata": {
        "<key>": {}
      }
    }
  ]
}

repositories_AddPackageAsset

POST/api/v1/actions/invoke/repositories_AddPackageAsset

Attach a repository asset to a package under the given filename.

Symmetric to AddPackageVersionAssetAction but for the package itself rather than a specific version. The asset must already exist in the same repository; the link carries an arbitrary metadata dictionary.

Request AddPackageAssetAction

  • packageIdstringPackageId
  • assetIdstringRepositoryAssetId
  • filenamestring
    • Filename must be between 1 and 256 characters.
  • metadatamap<string, any>JsonValueoptional

    Optional metadata to associate with the asset.

    Nexigon Hub rejects metadata larger than the instance's limit, 64 KiB by default.

Response AddPackageAssetOutput

One of the following, identified by result:

  • result: "FilenameAlreadyExists"

    An asset with the same filename already exists on this package.

  • result: "Added"

    The asset has been added.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "packageId": "<package-id>",
    "assetId": "<repository-asset-id>",
    "filename": "<filename>"
  }' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_AddPackageAsset
{
  "result": "FilenameAlreadyExists"
}

repositories_RemovePackageAsset

POST/api/v1/actions/invoke/repositories_RemovePackageAsset

Remove a package asset by filename.

Request RemovePackageAssetAction

  • packageIdstringPackageId
  • filenamestring
    • Filename must be between 1 and 256 characters.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"packageId":"<package-id>","filename":"<filename>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_RemovePackageAsset
{}

repositories_SetPackageAssetMetadata

POST/api/v1/actions/invoke/repositories_SetPackageAssetMetadata

Replace the metadata on a package asset.

Request SetPackageAssetMetadataAction

  • packageIdstringPackageId
  • filenamestring
    • Filename must be between 1 and 256 characters.
  • metadatamap<string, any>JsonValue

    Metadata to set (replaces existing metadata).

    Nexigon Hub rejects metadata larger than the instance's limit, 64 KiB by default.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "packageId": "<package-id>",
    "filename": "<filename>",
    "metadata": {
      "<key>": {}
    }
  }' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SetPackageAssetMetadata
{}

repositories_CreatePackage

POST/api/v1/actions/invoke/repositories_CreatePackage

Create a new package.

Request CreatePackageAction

  • presentationobjectPackagePresentationUpdateoptional

    Optional initial display information.

    3 fields
    • displayNamestringoptional

      Human-readable name. Omit to display the URL-safe package name.

      • Display name must be between 1 and 128 characters.
    • descriptionstringoptional

      CommonMark description. Raw HTML is not rendered by the Hub UI.

      • Description must be at most 65536 characters.
    • imageobjectPackageImageUpdateoptional

      Omit to preserve the current image, or leave a new package without an image.

      2 variants

      One of the following, identified by tag:

      • tag: "Replace"

        Replace with a base64-encoded static PNG, without a data URL prefix. Defaults to at most 1 MiB and 1024 pixels per side; see image_limits.

        • imagePngstring
      • tag: "Remove"

        Remove the current image.

  • repositoryIdstringRepositoryId

    ID of the repository.

  • namestring

    Name of the package.

    • Package name must be between 1 and 128 characters.
    • Package name must start with a letter or digit and contain only letters, digits, dots, underscores, or hyphens.
  • kindstringoptional

    Kind of the package (e.g., "rugix-app").

    • Package kind must be between 1 and 64 characters.
    • Package kind must start with a lowercase letter or digit and contain only lowercase letters, digits, dots, underscores, or hyphens.
  • metadatamap<string, any>JsonValueoptional

    Optional initial metadata.

    Nexigon Hub rejects metadata larger than the instance's limit, 64 KiB by default.

Response CreatePackageOutput

One of the following, identified by result:

  • result: "NameAlreadyExists"

    A package with the same name already exists.

  • result: "Created"

    The package has been created.

    • packageIdstringPackageId

      ID of the package.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"repositoryId":"<repository-id>","name":"<name>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_CreatePackage
{
  "result": "Created",
  "packageId": "<package-id>"
}

repositories_SetPackagePresentation

POST/api/v1/actions/invoke/repositories_SetPackagePresentation

Replace display text and optionally change the image. Omitted display name and description are cleared; an omitted image is preserved.

Request SetPackagePresentationAction

  • packageIdstringPackageId
  • presentationobjectPackagePresentationUpdate
    3 fields
    • displayNamestringoptional

      Human-readable name. Omit to display the URL-safe package name.

      • Display name must be between 1 and 128 characters.
    • descriptionstringoptional

      CommonMark description. Raw HTML is not rendered by the Hub UI.

      • Description must be at most 65536 characters.
    • imageobjectPackageImageUpdateoptional

      Omit to preserve the current image, or leave a new package without an image.

      2 variants

      One of the following, identified by tag:

      • tag: "Replace"

        Replace with a base64-encoded static PNG, without a data URL prefix. Defaults to at most 1 MiB and 1024 pixels per side; see image_limits.

        • imagePngstring
      • tag: "Remove"

        Remove the current image.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"packageId":"<package-id>","presentation":{}}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SetPackagePresentation
{}

repositories_DeletePackage

POST/api/v1/actions/invoke/repositories_DeletePackage

Delete a package.

Request DeletePackageAction

  • packageIdstringPackageId

    ID of the package.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"packageId":"<package-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_DeletePackage
{}

repositories_SetPackageMetadata

POST/api/v1/actions/invoke/repositories_SetPackageMetadata

Set metadata on a package.

Request SetPackageMetadataAction

  • packageIdstringPackageId

    ID of the package.

  • metadatamap<string, any>JsonValue

    Metadata to set (replaces existing metadata).

    Nexigon Hub rejects metadata larger than the instance's limit, 64 KiB by default.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"packageId":"<package-id>","metadata":{"<key>":{}}}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SetPackageMetadata
{}

repositories_SetPackageKind

POST/api/v1/actions/invoke/repositories_SetPackageKind

Set the kind of a package.

Request SetPackageKindAction

  • packageIdstringPackageId

    ID of the package.

  • kindstringoptional

    New kind of the package (e.g., "rugix-app"), or null to clear.

    • Package kind must be between 1 and 64 characters.
    • Package kind must start with a lowercase letter or digit and contain only lowercase letters, digits, dots, underscores, or hyphens.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"packageId":"<package-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SetPackageKind
{}

repositories_SetPackageName

POST/api/v1/actions/invoke/repositories_SetPackageName

Set the name of a package.

Request SetPackageNameAction

  • packageIdstringPackageId

    ID of the package.

  • namestring

    New name of the package.

    • Package name must be between 1 and 128 characters.
    • Package name must start with a letter or digit and contain only letters, digits, dots, underscores, or hyphens.

Response SetPackageNameOutput

One of the following, identified by result:

  • result: "NameAlreadyExists"

    A package with the same name already exists.

  • result: "Success"

    The name has been set.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"packageId":"<package-id>","name":"<name>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SetPackageName
{
  "result": "NameAlreadyExists"
}

repositories_QueryPackageVersions

POST/api/v1/actions/invoke/repositories_QueryPackageVersions

Query a page of the versions of a package, newest first.

Request QueryPackageVersionsAction

  • packageIdstringPackageId

    ID of the package.

  • filterobjectPackageVersionFilteroptional

    Only return versions matching this filter.

    2 fields
    • releasebooleanoptional

      Only return versions with this release status.

    • searchstringoptional

      Case-insensitive substring of the version's name, ID, or one of its tags.

  • pageobjectPageRequestoptional

    Page to return. Without this field, the first page is returned.

    2 fields
    • limitintegeroptional

      Maximum number of items. The default depends on the endpoint and the ceiling is configured by the Hub operator (1000 by default).

      • Page limit must be positive.
    • cursorstringPageCursoroptional

      Continue the same endpoint, scope, filters, and ordering.

Response QueryPackageVersionsOutput

  • versionsarray<object>QueryPackageVersionsItem

    Versions on this page.

    11 fields
    • versionIdstringPackageVersionId

      ID of the package version.

    • namestringoptional

      Optional name of the version.

    • createdAtstring (date-time)Timestamp

      Timestamp when the package version was created.

    • deleteAtstring (date-time)Timestampoptional

      Explicit deletion deadline. Package retention can delete the version earlier.

    • sealedbooleanoptional

      Sealed versions reject content changes and deletion, except by deleting their repository. Absent on older Hub versions.

    • releasebooleanoptional

      Releases are retained indefinitely. Independent of sealing. Absent on older Hub versions.

    • tagsarray<object>PackageVersionTag

      Tags of the package version.

      3 fields
      • tagstring

        Tag of the package version.

      • lockedboolean

        Indicates whether the tag is locked.

      • assignedAtstring (date-time)Timestampoptional

        Time at which the tag was assigned to the version. Absent on older Hub versions.

    • baseVersionIdstringPackageVersionIdoptional

      Version that a device must run before installing this version.

    • baseVersionNamestringoptional

      Optional name of the base version.

    • assetCountinteger (64-bit)optional

      Number of assets of the version. Absent on older Hub versions.

    • assetSizeinteger (64-bit)optional

      Total size of the version's assets in bytes. Absent on older Hub versions.

  • pageobjectPageInfo

    Continuation of the traversal.

    1 field
    • nextCursorstringPageCursoroptional

      Cursor for the next page; absent when no more matching rows were visible.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"packageId":"<package-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_QueryPackageVersions
{
  "versions": [
    {
      "versionId": "<package-version-id>",
      "createdAt": "2026-01-01T12:00:00Z",
      "tags": [
        {
          "tag": "<tag>",
          "locked": true
        }
      ]
    }
  ],
  "page": {}
}

repositories_QueryPackageTags

POST/api/v1/actions/invoke/repositories_QueryPackageTags

Query a page of the tags of a package, most recently assigned first.

Request QueryPackageTagsAction

  • packageIdstringPackageId

    ID of the package.

  • filterobjectPackageTagFilteroptional

    Only return tags matching this filter.

    1 field
    • searchstringoptional

      Case-insensitive substring of the tag.

  • pageobjectPageRequestoptional

    Page to return. Without this field, the first page is returned.

    2 fields
    • limitintegeroptional

      Maximum number of items. The default depends on the endpoint and the ceiling is configured by the Hub operator (1000 by default).

      • Page limit must be positive.
    • cursorstringPageCursoroptional

      Continue the same endpoint, scope, filters, and ordering.

Response QueryPackageTagsOutput

  • tagsarray<object>QueryPackageTagsItem

    Tags on this page.

    5 fields
    • tagstring

      Tag.

    • lockedboolean

      Indicates whether the tag is locked.

    • assignedAtstring (date-time)Timestamp

      Time at which the tag was assigned to its version.

    • versionIdstringPackageVersionId

      ID of the version the tag points to.

    • versionNamestringoptional

      Optional name of the version the tag points to.

  • pageobjectPageInfo

    Continuation of the traversal.

    1 field
    • nextCursorstringPageCursoroptional

      Cursor for the next page; absent when no more matching rows were visible.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"packageId":"<package-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_QueryPackageTags
{
  "tags": [
    {
      "tag": "<tag>",
      "locked": true,
      "assignedAt": "2026-01-01T12:00:00Z",
      "versionId": "<package-version-id>"
    }
  ],
  "page": {}
}

repositories_ResolveVersionByPath

POST/api/v1/actions/invoke/repositories_ResolveVersionByPathDevice API

Resolve a package version by its path.

A path consists of a repository, a package, and a version tag. Devices can resolve versions in repositories linked to their project.

Within an organization, the repository is given by its path name. The organization defaults to that of the request, which is set by an organization API token, the X-Nexigon-Organization header, or the project of a device. Without an organization, the repository is given by its slug. A repository ID resolves in both cases.

Request ResolvePackageVersionByPathAction

  • organizationIdstringOrganizationIdoptional

    Organization to resolve path names in.

    Defaults to the organization of the request. See the action for details.

  • repositorystring

    Path name, slug, or ID of the repository.

    • Repository name must be between 1 and 128 characters.
    • Repository name must start with a letter or digit and contain only letters, digits, dots, underscores, or hyphens.
  • packagestring

    Name or ID of the package.

    • Package name must be between 1 and 128 characters.
    • Package name must start with a letter or digit and contain only letters, digits, dots, underscores, or hyphens.
  • tagstring

    Tag or ID of the version.

    • Tag must be between 1 and 128 characters.
    • Tag must start with a letter or digit and contain only letters, digits, dots, plus signs, tildes, underscores, or hyphens.

Response ResolvePackageVersionByPathOutput

One of the following, identified by result:

  • result: "Found"

    The package version has been found.

    • repositoryIdstringRepositoryId

      ID of the repository.

    • packageIdstringPackageId

      ID of the package.

    • versionIdstringPackageVersionId

      ID of the package version.

  • result: "NotFound"

    The package version has not been found.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "repository": "<repository>",
    "package": "<package>",
    "tag": "<tag>"
  }' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_ResolveVersionByPath
{
  "result": "Found",
  "repositoryId": "<repository-id>",
  "packageId": "<package-id>",
  "versionId": "<package-version-id>"
}

repositories_GetVersionDetails

POST/api/v1/actions/invoke/repositories_GetVersionDetailsDevice API

Get information about a package version.

Request GetPackageVersionDetailsAction

  • versionIdstringPackageVersionId

    ID of the package version.

Response GetPackageVersionDetailsOutput

  • versionIdstringPackageVersionId

    ID of the package version.

  • repositoryIdstringRepositoryId

    ID of the repository.

  • packageIdstringPackageId

    ID of the package.

  • namestringoptional

    Optional name of the version.

  • assetsarray<object>PackageVersionAsset

    Assets of the version.

    7 fields
    • filenamestring

      Filename of the asset.

    • assetIdstringRepositoryAssetId

      ID of the asset.

    • sizeinteger (64-bit)

      Size of the asset.

    • digeststringDigest

      Digest of the asset.

    • statusstringRepositoryAssetStatus

      Status of the asset.

      • "Dangling"

        The asset has been created but not yet uploaded.

      • "Available"

        The asset has been uploaded and is available.

      • "Deleting"

        The asset is in the process of being deleted.

    • storageobjectRepositoryAssetStorageoptional

      Latest storage check. Absent when connected to an older Hub.

      3 fields
      • statusstringRepositoryAssetStorageStatus
        • "Unknown"

          The asset has not been checked yet.

        • "Present"

          A legacy object exists with the expected size, but has no verifiable checksum metadata.

        • "Verified"

          The object carries matching size, checksum, digest, and ownership metadata.

        • "Missing"

          No object exists at the expected key.

        • "Mismatched"

          The object exists but its size or verification metadata does not match.

        • "Error"

          The storage provider could not be checked.

      • checkedAtstring (date-time)Timestampoptional
      • detailstringoptional
    • metadatamap<string, any>JsonValue

      Arbitrary metadata associated with this asset in the version.

  • tagsarray<object>PackageVersionTag

    Tags of the version.

    3 fields
    • tagstring

      Tag of the package version.

    • lockedboolean

      Indicates whether the tag is locked.

    • assignedAtstring (date-time)Timestampoptional

      Time at which the tag was assigned to the version. Absent on older Hub versions.

  • metadatamap<string, any>JsonValue

    Version-level metadata.

  • deleteAtstring (date-time)Timestampoptional

    Explicit deletion deadline. Package retention can delete the version earlier.

  • sealedbooleanoptional

    Sealed versions reject content changes and deletion, except by deleting their repository. Absent on older Hub versions.

  • releasebooleanoptional

    Releases are retained indefinitely. Independent of sealing. Absent on older Hub versions.

  • baseVersionIdstringPackageVersionIdoptional

    Version that a device must run before installing this version.

  • createdAtstring (date-time)Timestampoptional

    Timestamp when the package version was created. Absent on older Hub versions.

  • baseVersionNamestringoptional

    Optional name of the base version.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"versionId":"<package-version-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_GetVersionDetails
{
  "versionId": "<package-version-id>",
  "repositoryId": "<repository-id>",
  "packageId": "<package-id>",
  "assets": [
    {
      "filename": "<filename>",
      "assetId": "<repository-asset-id>",
      "size": 1,
      "digest": "<digest>",
      "status": "Dangling",
      "metadata": {
        "<key>": {}
      }
    }
  ],
  "tags": [
    {
      "tag": "<tag>",
      "locked": true
    }
  ],
  "metadata": {
    "<key>": {}
  }
}

repositories_CreateVersion

POST/api/v1/actions/invoke/repositories_CreateVersion

Create a new package version.

Request CreatePackageVersionAction

  • packageIdstringPackageId

    ID of the package.

  • namestringoptional

    Optional name of the version.

    • Version name must be between 1 and 128 characters.
  • deleteAtstring (date-time)Timestampoptional

    Earliest automatic deletion time; must be in the future. Package retention applies independently. Removes the version and all tags. Unused assets follow repository cleanup policy.

  • tagsarray<object>AddTagItemoptional

    Tags to add to the package version.

    3 fields
    • tagstring

      Tag to add.

      • Tag must be between 1 and 128 characters.
      • Tag must start with a letter or digit and contain only letters, digits, dots, plus signs, tildes, underscores, or hyphens.
    • lockedbooleanoptional

      Indicates whether the tag should be locked.

      Defaults to false.

    • reassignbooleanoptional

      Indicates whether the tag should be reassigned, if it already exists.

      Defaults to false. Adding a tag that is assigned to another version fails unless the tag is reassigned. Locked tags are never reassigned.

  • metadatamap<string, any>JsonValueoptional

    Optional initial metadata.

    Nexigon Hub rejects metadata larger than the instance's limit, 64 KiB by default.

  • baseVersionIdstringPackageVersionIdoptional

    Version that a device must run before installing this version.

    Must belong to the same package and must not be scheduled for deletion.

Response CreatePackageVersionOutput

One of the following, identified by result:

  • result: "Created"

    The package version has been created.

    • versionIdstringPackageVersionId

      ID of the package version.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"packageId":"<package-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_CreateVersion
{
  "result": "Created",
  "versionId": "<package-version-id>"
}

repositories_DeleteVersion

POST/api/v1/actions/invoke/repositories_DeleteVersion

Delete a package version.

A version that is the base of another version cannot be deleted.

Request DeletePackageVersionAction

  • versionIdstringPackageVersionId

    ID of the package version.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"versionId":"<package-version-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_DeleteVersion
{}

repositories_SetVersionDeletionSchedule

POST/api/v1/actions/invoke/repositories_SetVersionDeletionSchedule

Schedule or cancel automatic deletion. Requires permission to manage versions. Deletion removes the version and all tags, including locked tags. It does not check device installations. Unused assets follow the repository cleanup policy. A version that is the base of another version cannot be scheduled.

Request SetPackageVersionDeletionScheduleAction

  • versionIdstringPackageVersionId
  • deleteAtstring (date-time)Timestampoptional

    Future deadline. Null or omission cancels this schedule; package retention still applies. A deadline makes deletion eligible; background processing may delay it.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"versionId":"<package-version-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SetVersionDeletionSchedule
{}

repositories_SetVersionName

POST/api/v1/actions/invoke/repositories_SetVersionName

Set the name of a package version.

Request SetPackageVersionNameAction

  • versionIdstringPackageVersionId

    ID of the package version.

  • namestringoptional

    New name of the package version.

    • Version name must be between 1 and 128 characters.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"versionId":"<package-version-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SetVersionName
{}

repositories_SetVersionBase

POST/api/v1/actions/invoke/repositories_SetVersionBase

Set or clear the base of a package version. Requires permission to manage versions.

The base must belong to the same package, must not be scheduled for deletion, and must not lead back to the version through its own bases. Sealed versions reject changes to their base.

Request SetPackageVersionBaseAction

  • versionIdstringPackageVersionId

    ID of the package version.

  • baseVersionIdstringPackageVersionIdoptional

    New base version. Omit to clear the base.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"versionId":"<package-version-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SetVersionBase
{}

repositories_SetVersionMetadata

POST/api/v1/actions/invoke/repositories_SetVersionMetadata

Set metadata on a package version.

Request SetPackageVersionMetadataAction

  • versionIdstringPackageVersionId

    ID of the package version.

  • metadatamap<string, any>JsonValue

    Metadata to set (replaces existing metadata).

    Nexigon Hub rejects metadata larger than the instance's limit, 64 KiB by default.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"versionId":"<package-version-id>","metadata":{"<key>":{}}}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SetVersionMetadata
{}

repositories_AddVersionAsset

POST/api/v1/actions/invoke/repositories_AddVersionAsset

Add an asset to a package version.

Request AddPackageVersionAssetAction

  • versionIdstringPackageVersionId

    ID of the package version.

  • assetIdstringRepositoryAssetId

    ID of the asset.

  • filenamestring

    Filename of the asset.

    • Filename must be between 1 and 256 characters.
  • metadatamap<string, any>JsonValueoptional

    Optional metadata to associate with this asset in the version.

    Nexigon Hub rejects metadata larger than the instance's limit, 64 KiB by default.

Response AddPackageVersionAssetOutput

One of the following, identified by result:

  • result: "FilenameAlreadyExists"

    An asset with the same filename already exists.

  • result: "Added"

    The asset has been added to the package version.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "versionId": "<package-version-id>",
    "assetId": "<repository-asset-id>",
    "filename": "<filename>"
  }' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_AddVersionAsset
{
  "result": "FilenameAlreadyExists"
}

repositories_RemoveVersionAsset

POST/api/v1/actions/invoke/repositories_RemoveVersionAsset

Remove an asset from a package version.

Request RemovePackageVersionAssetAction

  • versionIdstringPackageVersionId

    ID of the package version.

  • filenamestring

    Filename of the asset.

    • Filename must be between 1 and 256 characters.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"versionId":"<package-version-id>","filename":"<filename>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_RemoveVersionAsset
{}

repositories_SetVersionAssetMetadata

POST/api/v1/actions/invoke/repositories_SetVersionAssetMetadata

Set metadata on a package version asset.

Request SetPackageVersionAssetMetadataAction

  • versionIdstringPackageVersionId

    ID of the package version.

  • filenamestring

    Filename of the asset.

    • Filename must be between 1 and 256 characters.
  • metadatamap<string, any>JsonValue

    Metadata to set (replaces existing metadata).

    Nexigon Hub rejects metadata larger than the instance's limit, 64 KiB by default.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "versionId": "<package-version-id>",
    "filename": "<filename>",
    "metadata": {
      "<key>": {}
    }
  }' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SetVersionAssetMetadata
{}

repositories_TagVersion

POST/api/v1/actions/invoke/repositories_TagVersion

Add tags to a version.

Request TagPackageVersionAction

  • versionIdstringPackageVersionId

    ID of the package version.

  • tagsarray<object>AddTagItem

    Tags to add.

    3 fields
    • tagstring

      Tag to add.

      • Tag must be between 1 and 128 characters.
      • Tag must start with a letter or digit and contain only letters, digits, dots, plus signs, tildes, underscores, or hyphens.
    • lockedbooleanoptional

      Indicates whether the tag should be locked.

      Defaults to false.

    • reassignbooleanoptional

      Indicates whether the tag should be reassigned, if it already exists.

      Defaults to false. Adding a tag that is assigned to another version fails unless the tag is reassigned. Locked tags are never reassigned.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "versionId": "<package-version-id>",
    "tags": [
      {
        "tag": "<tag>"
      }
    ]
  }' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_TagVersion
{}

repositories_UntagVersion

POST/api/v1/actions/invoke/repositories_UntagVersion

Remove tags from a version.

Request UntagPackageVersionAction

  • versionIdstringPackageVersionId

    ID of the package version.

  • tagsarray<object>RemoveTagItem

    Tags to remove.

    1 field
    • tagstring

      Tag to remove.

      • Tag must be between 1 and 128 characters.
      • Tag must start with a letter or digit and contain only letters, digits, dots, plus signs, tildes, underscores, or hyphens.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "versionId": "<package-version-id>",
    "tags": [
      {
        "tag": "<tag>"
      }
    ]
  }' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_UntagVersion
{}

repositories_ResolveVersionAssetByPath

POST/api/v1/actions/invoke/repositories_ResolveVersionAssetByPathDevice API

Resolve a version asset by its path.

A path consists of a repository, a package, a version tag, and the asset's filename within the version.

Within an organization, the repository is given by its path name. The organization defaults to that of the request, which is set by an organization API token, the X-Nexigon-Organization header, or the project of a device. Without an organization, the repository is given by its slug. A repository ID resolves in both cases.

Request ResolvePackageVersionAssetByPathAction

  • organizationIdstringOrganizationIdoptional

    Organization to resolve path names in.

    Defaults to the organization of the request. See the action for details.

  • repositorystring

    Path name, slug, or ID of the repository.

    • Repository name must be between 1 and 128 characters.
    • Repository name must start with a letter or digit and contain only letters, digits, dots, underscores, or hyphens.
  • packagestring

    Name or ID of the package.

    • Package name must be between 1 and 128 characters.
    • Package name must start with a letter or digit and contain only letters, digits, dots, underscores, or hyphens.
  • tagstring

    Tag or ID of the version.

    • Tag must be between 1 and 128 characters.
    • Tag must start with a letter or digit and contain only letters, digits, dots, plus signs, tildes, underscores, or hyphens.
  • filenamestring

    Filename or ID of the asset.

    • Filename must be between 1 and 256 characters.

Response ResolvePackageVersionAssetByPathOutput

One of the following, identified by result:

  • result: "Found"

    The asset has been found.

    • repositoryIdstringRepositoryId

      ID of the repository.

    • packageIdstringPackageId

      ID of the package.

    • versionIdstringPackageVersionId

      ID of the package version.

    • assetIdstringRepositoryAssetId

      ID of the asset.

  • result: "NotFound"

    The asset has not been found.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "repository": "<repository>",
    "package": "<package>",
    "tag": "<tag>",
    "filename": "<filename>"
  }' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_ResolveVersionAssetByPath
{
  "result": "Found",
  "repositoryId": "<repository-id>",
  "packageId": "<package-id>",
  "versionId": "<package-version-id>",
  "assetId": "<repository-asset-id>"
}

repositories_SetS3Config

POST/api/v1/actions/invoke/repositories_SetS3Config

Set the S3 configuration for the repository.

Request SetRepositoryS3ConfigAction

  • repositoryIdstringRepositoryId

    ID of the repository.

  • s3ConfigobjectRepositoryS3Config

    S3 config for the repository.

    7 fields
    • endpointstring
      • S3 endpoint must be between 1 and 2048 characters.
      • S3 endpoint must be an HTTP(S) URL.
    • bucketstring

      S3 bucket name.

      • S3 bucket name must be between 3 and 63 characters.
      • S3 bucket name must use only lowercase letters, digits, dots, and hyphens, and start and end with a letter or digit.
    • regionstringoptional

      AWS region (required by AWS, may be NULL for MinIO/other providers).

      • AWS region must be between 1 and 64 characters.
    • prefixstringoptional

      Optional bucket prefix. Organization storage adds repositories/<repository-id>/.

      • Bucket prefix must be at most 1024 characters.
    • forcePathStylebooleanoptional

      Force path-style bucket addressing. By default, Nexigon uses virtual-hosted addressing.

    • accessKeyIdstring

      S3 access key ID (not sensitive, can be plain text).

      • Access key ID must be between 1 and 256 characters.
    • secretAccessKeystringoptional

      S3 secret access key (sensitive, will be stored encrypted).

      • Secret access key must be between 1 and 256 characters.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "repositoryId": "<repository-id>",
    "s3Config": {
      "endpoint": "<endpoint>",
      "bucket": "<bucket>",
      "accessKeyId": "<access-key-id>"
    }
  }' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SetS3Config
{}

repositories_GetS3Config

POST/api/v1/actions/invoke/repositories_GetS3Config

Get the S3 configuration for the repository.

Request GetRepositoryS3ConfigAction

  • repositoryIdstringRepositoryId

    ID of the repository.

Response GetRepositoryS3ConfigOutput

  • sourcestringRepositoryStorageSource

    Effective storage source. Inherited credentials are not exposed here.

    • "Unconfigured"
    • "Repository"
    • "Organization"
  • s3ConfigobjectRepositoryS3Config

    S3 config for the repository.

    7 fields
    • endpointstring
      • S3 endpoint must be between 1 and 2048 characters.
      • S3 endpoint must be an HTTP(S) URL.
    • bucketstring

      S3 bucket name.

      • S3 bucket name must be between 3 and 63 characters.
      • S3 bucket name must use only lowercase letters, digits, dots, and hyphens, and start and end with a letter or digit.
    • regionstringoptional

      AWS region (required by AWS, may be NULL for MinIO/other providers).

      • AWS region must be between 1 and 64 characters.
    • prefixstringoptional

      Optional bucket prefix. Organization storage adds repositories/<repository-id>/.

      • Bucket prefix must be at most 1024 characters.
    • forcePathStylebooleanoptional

      Force path-style bucket addressing. By default, Nexigon uses virtual-hosted addressing.

    • accessKeyIdstring

      S3 access key ID (not sensitive, can be plain text).

      • Access key ID must be between 1 and 256 characters.
    • secretAccessKeystringoptional

      S3 secret access key (sensitive, will be stored encrypted).

      • Secret access key must be between 1 and 256 characters.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"repositoryId":"<repository-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_GetS3Config
{
  "source": "Unconfigured",
  "s3Config": {
    "endpoint": "<endpoint>",
    "bucket": "<bucket>",
    "accessKeyId": "<access-key-id>"
  }
}

repositories_GetAssetDetails

POST/api/v1/actions/invoke/repositories_GetAssetDetails

Get information about an asset.

Request GetAssetDetailsAction

  • assetIdstringRepositoryAssetId

    ID of the asset.

Response GetAssetDetailsOutput

  • assetIdstringRepositoryAssetId

    ID of the asset.

  • sizeinteger (64-bit)

    Size of the asset.

  • digeststringDigest

    Digest of the asset.

  • statusstringRepositoryAssetStatus

    Status of the asset.

    • "Dangling"

      The asset has been created but not yet uploaded.

    • "Available"

      The asset has been uploaded and is available.

    • "Deleting"

      The asset is in the process of being deleted.

  • storageobjectRepositoryAssetStorageoptional

    Latest storage check. Absent when connected to an older Hub.

    3 fields
    • statusstringRepositoryAssetStorageStatus
      • "Unknown"

        The asset has not been checked yet.

      • "Present"

        A legacy object exists with the expected size, but has no verifiable checksum metadata.

      • "Verified"

        The object carries matching size, checksum, digest, and ownership metadata.

      • "Missing"

        No object exists at the expected key.

      • "Mismatched"

        The object exists but its size or verification metadata does not match.

      • "Error"

        The storage provider could not be checked.

    • checkedAtstring (date-time)Timestampoptional
    • detailstringoptional
  • referenceCountinteger (64-bit)

    Number of package and package-version attachments that retain the asset.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"assetId":"<repository-asset-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_GetAssetDetails
{
  "assetId": "<repository-asset-id>",
  "size": 1,
  "digest": "<digest>",
  "status": "Dangling",
  "referenceCount": 1
}

repositories_CreateAsset

POST/api/v1/actions/invoke/repositories_CreateAsset

Create an asset.

Request CreateAssetAction

  • repositoryIdstringRepositoryId

    ID of the repository.

  • sizeinteger (64-bit)

    Size of the asset.

  • digeststringDigest

    Digest of the asset.

Response CreateAssetOutput

One of the following, identified by result:

  • result: "AssetAlreadyExists"

    An asset with the same digest already exists.

    • assetIdstringRepositoryAssetId
  • result: "Created"

    The asset has been created.

    • assetIdstringRepositoryAssetId

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "repositoryId": "<repository-id>",
    "size": 1,
    "digest": "<digest>"
  }' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_CreateAsset
{
  "result": "AssetAlreadyExists",
  "assetId": "<repository-asset-id>"
}

repositories_DeleteAsset

POST/api/v1/actions/invoke/repositories_DeleteAsset

Schedule deletion of an unused asset. Referenced assets are rejected. The asset remains visible until object-storage deletion completes.

Request DeleteAssetAction

  • assetIdstringRepositoryAssetId

    ID of the asset.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"assetId":"<repository-asset-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_DeleteAsset
{}

repositories_IssueAssetDownloadUrl

POST/api/v1/actions/invoke/repositories_IssueAssetDownloadUrlDevice API

Issue a URL for downloading an asset.

The URL is valid for two hours and requires no further authentication.

Request IssueAssetDownloadUrlAction

  • assetIdstringRepositoryAssetId

    ID of the asset to issue the URL for.

  • filenamestringoptional

    Filename under which browsers save the download, set through the Content-Disposition header of the download response.

    • Filename must be between 1 and 256 characters.

Response IssueAssetDownloadUrlOutput

  • urlstring

    URL for downloading the asset.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"assetId":"<repository-asset-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_IssueAssetDownloadUrl
{
  "url": "<url>"
}

repositories_IssueAssetUploadUrl

POST/api/v1/actions/invoke/repositories_IssueAssetUploadUrl

Issue a URL for uploading an asset.

Request IssueAssetUploadUrlAction

  • assetIdstringRepositoryAssetId

    ID of the asset to issue the URL for.

Response IssueAssetUploadUrlOutput

  • urlstring

    Compatibility URL for uploading the asset without verification headers.

    Objects uploaded through this URL remain dangling. New clients should use verified_url, apply every entry in headers, and finalize the upload.

  • verifiedUrlstringoptional

    URL for an upload whose digest and ownership Nexigon Hub can verify.

  • headersmap<string, string>optional

    Headers that must accompany a request to verified_url.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"assetId":"<repository-asset-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_IssueAssetUploadUrl
{
  "url": "<url>"
}

repositories_FinalizeAssetUpload

POST/api/v1/actions/invoke/repositories_FinalizeAssetUpload

Verify an uploaded object and make its asset available.

This action is idempotent: finalizing an already available asset succeeds.

Request FinalizeAssetUploadAction

  • assetIdstringRepositoryAssetId

    ID of the pending asset to finalize.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"assetId":"<repository-asset-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_FinalizeAssetUpload
{}

repositories_QueryAuditLog

POST/api/v1/actions/invoke/repositories_QueryAuditLog

Query the audit log of the repository.

Request QueryAuditLogEventsAction

  • pageobjectPageRequestoptional

    Opt into cursor pagination. Without this field, the existing limit applies.

    2 fields
    • limitintegeroptional

      Maximum number of items. The default depends on the endpoint and the ceiling is configured by the Hub operator (1000 by default).

      • Page limit must be positive.
    • cursorstringPageCursoroptional

      Continue the same endpoint, scope, filters, and ordering.

  • repositoryIdstringRepositoryId

    ID of the repository.

Response QueryAuditLogEventsOutput

  • pageobjectPageInfooptional

    Present when cursor pagination was requested.

    1 field
    • nextCursorstringPageCursoroptional

      Cursor for the next page; absent when no more matching rows were visible.

  • eventsarray<object>AuditLogEvent

    List of audit log events.

    7 fields
    • eventIdstringAuditLogEventId

      ID of the audit log event.

    • actorobjectActor

      Actor causing the event.

      7 variants

      One of the following, identified by actor:

      • actor: "Anonymous"

        An anonymous, unauthenticated actor.

      • actor: "System"

        The system itself, typically used for internal actions.

      • actor: "Device"

        A device authenticated via a specific deployment token.

        • deviceIdstringDeviceId

          ID of the device.

        • tokenIdstringDeploymentTokenId

          ID of the deployment token used for authentication.

      • actor: "User"

        A user typically authenticated via a user session.

        • userIdstringUserId

          ID of the user.

      • actor: "UserToken"

        A user authenticated via a specific token.

        • userIdstringUserId

          ID of the user.

        • tokenIdstringUserTokenId

          ID of the user token used for authentication.

      • actor: "ClusterNode"

        A cluster node.

        • nodeIdstringClusterNodeId

          ID of the cluster node.

      • actor: "OrganizationApiToken"

        An organization API token.

        • organizationIdstringOrganizationId

          ID of the organization.

        • tokenIdstringOrganizationApiTokenId

          ID of the API token.

    • eventstring

      Type of the event that was recorded.

    • dataanyJsonValue

      Additional audit data associated with the event.

    • createdAtstring (date-time)Timestamp

      Timestamp indicating when the audit log event was recorded.

    • actionobjectAuditLogEventActionoptional

      Action the event has been caused by (if any).

      1 field
      • actionIdstringAuditLogActionId

        ID of the action.

    • jobobjectAuditLogEventJoboptional

      Job the event has been caused by (if any).

      1 field
      • jobIdstringJobId

        ID of the job.

  • referencesobjectAuditLogReferencesoptional

    Names of the actors of the returned events.

    Absent in responses of Nexigon Hub 2026.3 and earlier.

    3 fields
    • usersarray<object>AuditLogUserReference

      Users acting directly or through a user token.

      3 fields
      • userIdstringUserId

        ID of the user.

      • displayNamestringoptional

        Name of the user.

      • emailstring

        Email of the user.

    • devicesarray<object>AuditLogDeviceReference

      Devices.

      2 fields
      • deviceIdstringDeviceId

        ID of the device.

      • namestring

        Name of the device.

    • organizationApiTokensarray<object>AuditLogOrganizationApiTokenReference

      Organization API tokens.

      2 fields
      • tokenIdstringOrganizationApiTokenId

        ID of the API token.

      • namestring

        Name of the API token.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"repositoryId":"<repository-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_QueryAuditLog
{
  "events": [
    {
      "eventId": "<audit-log-event-id>",
      "actor": {
        "actor": "Device",
        "deviceId": "<device-id>",
        "tokenId": "<deployment-token-id>"
      },
      "event": "<event>",
      "data": {},
      "createdAt": "2026-01-01T12:00:00Z"
    }
  ]
}

repositories_DeleteS3Config

POST/api/v1/actions/invoke/repositories_DeleteS3Config

Remove a repository override and use organization storage when configured.

Request DeleteRepositoryS3ConfigAction

  • repositoryIdstringRepositoryId

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"repositoryId":"<repository-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_DeleteS3Config
{}

repositories_SetPackageVersionRetention

POST/api/v1/actions/invoke/repositories_SetPackageVersionRetention

Replace the package retention policy. Requires permission to manage versions.

Request SetPackageVersionRetentionAction

  • packageIdstringPackageId
  • retentionobjectPackageVersionRetention
    3 fields
    • enabledboolean
    • maxVersionsintegeroptional

      Maximum number of newest eligible versions to keep. Protected versions do not count.

      • Version count must be a positive integer.
    • maxAgeDaysintegeroptional

      Maximum age in fixed 24-hour days. This can expire every eligible version.

      • Maximum age must be a positive number of days.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"packageId":"<package-id>","retention":{"enabled":true}}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SetPackageVersionRetention
{}

repositories_SealVersion

POST/api/v1/actions/invoke/repositories_SealVersion

Permanently seal a version. Requires permission to manage versions. Sealing cancels scheduled deletion and blocks changes to the name, metadata, base version, and attachments, as well as deletion of the version or package. Deleting the repository deletes sealed versions, too. Tags remain editable. Sealing cannot be reversed.

Request SealPackageVersionAction

  • versionIdstringPackageVersionId

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"versionId":"<package-version-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SealVersion
{}

repositories_SetVersionRelease

POST/api/v1/actions/invoke/repositories_SetVersionRelease

Set or remove release status. Requires permission to manage versions. Releases are retained indefinitely and block deletion of their package. Deleting the repository deletes releases, too. Marking a release cancels scheduled deletion. Removing the marker does not restore it. Release status does not seal contents and can also change on sealed versions.

Request SetPackageVersionReleaseAction

  • versionIdstringPackageVersionId
  • releaseboolean

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"versionId":"<package-version-id>","release":true}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/repositories_SetVersionRelease
{}