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
organizationIdstringOrganizationIdoptionalOrganization to resolve path names in.
Defaults to the organization of the request. See the action for details.
repositorystringPath 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
repositoryIdstringRepositoryIdID of the repository.
Response GetRepositoryDetailsOutput
repositoryIdstringRepositoryIdID of the repository.
displayNamestringDisplay name of the repository.
pathNamestringoptionalPath name of the repository, unique within its organization.
Absent on older Hub versions.
slugstringoptionalSlug of the repository, unique on the instance, if one has been set.
publicNamestring- Deprecated — removed in
2029.2— Useslug, which is absent when no slug is set.
Public name of the repository.
Falls back to the repository ID when no slug is set.
- Deprecated — removed in
visibilitystringRepositoryVisibilityVisibility 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
organizationIdstringOrganizationIdOrganization to create the repository in.
displayNamestringDisplay name of the repository.
Free-form, human-facing name.
- Display name must be between 1 and 128 characters.
pathNamestringoptionalPath name of the repository, unique within the organization.
Defaults to
default, with a numeric suffix such asdefault-2if 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.
visibilitystringRepositoryVisibilityoptionalVisibility 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.
repositoryIdstringRepositoryIdID 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
repositoryIdstringRepositoryIdID 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
repositoryIdstringRepositoryIdID of the repository.
visibilitystringRepositoryVisibilityNew 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
repositoryIdstringRepositoryIdID of the repository.
displayNamestringNew 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
repositoryIdstringRepositoryIdID of the repository.
pathNamestringNew 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
repositoryIdstringRepositoryIdID of the repository.
slugstringNew 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
repositoryIdstringRepositoryIdID of the repository.
Response QueryRepositoryPackagesOutput
packagesarray<object>QueryRepositoryPackagesItemList of packages.
9 fields
displayNamestringoptionalHuman-readable name, falling back to
namewhen absent.packageIdstringPackageIdID of the package.
namestringName of the package.
kindstringoptionalKind of the package (e.g., "rugix-app").
createdAtstring (date-time)TimestampTimestamp when the package was created.
descriptionstringoptionalCommonMark description. Absent when not set or on older Hub versions.
imageUrlstringoptionalRoot-relative URL for the PNG on this Hub. Absent when no image is set.
versionCountinteger (64-bit)optionalNumber of versions of the package. Absent on older Hub versions.
latestVersionobjectQueryPackageVersionsItemoptionalMost recently created version. Absent when the package has no versions or on older Hub versions.
11 fields
versionIdstringPackageVersionIdID of the package version.
namestringoptionalOptional name of the version.
createdAtstring (date-time)TimestampTimestamp when the package version was created.
deleteAtstring (date-time)TimestampoptionalExplicit deletion deadline. Package retention can delete the version earlier.
sealedbooleanoptionalSealed versions reject content changes and deletion, except by deleting their repository. Absent on older Hub versions.
releasebooleanoptionalReleases are retained indefinitely. Independent of sealing. Absent on older Hub versions.
tagsarray<object>PackageVersionTagTags of the package version.
3 fields
tagstringTag of the package version.
lockedbooleanIndicates whether the tag is locked.
assignedAtstring (date-time)TimestampoptionalTime at which the tag was assigned to the version. Absent on older Hub versions.
baseVersionIdstringPackageVersionIdoptionalVersion that a device must run before installing this version.
baseVersionNamestringoptionalOptional name of the base version.
assetCountinteger (64-bit)optionalNumber of assets of the version. Absent on older Hub versions.
assetSizeinteger (64-bit)optionalTotal 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
repositoryIdstringRepositoryIdID of the repository.
pageobjectPageRequestoptionalBounded cursor page. Omission preserves the legacy unbounded response.
2 fields
limitintegeroptionalMaximum 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.
cursorstringPageCursoroptionalContinue the same endpoint, scope, filters, and ordering.
filterstringRepositoryAssetFilteroptionalDefaults to all assets. Totals always cover the whole repository.
"All""Unused""Issues"
sortstringRepositoryAssetSortoptionalDefaults to largest first for pages, creation order for legacy requests.
"Largest""CleanupDate"
Response QueryRepositoryAssetsOutput
assetsarray<object>QueryRepositoryAssetsItemList of assets.
5 fields
lifecycleobjectRepositoryAssetLifecycleoptionalReference count and cleanup status. Absent on older Hubs.
5 fields
referenceCountinteger (64-bit)unreferencedSincestring (date-time)TimestampoptionaleligibleAtstring (date-time)TimestampoptionalEarliest automatic deletion time; absent while cleanup is disabled or referenced.
deletionStartedAtstring (date-time)TimestampoptionaldeletionErrorstringoptionalSanitized reason for the latest cleanup failure.
assetIdstringRepositoryAssetIdID of the asset.
sizeinteger (64-bit)Size of the asset.
digeststringDigestDigest of the asset.
storageobjectRepositoryAssetStorageoptionalLatest 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)Timestampoptionaldetailstringoptional
usageobjectRepositoryAssetUsageoptionalRepository-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)TimestampoptionalOldest storage observation among stored assets.
cleanupobjectRepositoryAssetCleanupSettingsoptionalAutomatic cleanup policy. Absent on older Hubs.
3 fields
enabledbooleangraceDaysintegerWhole days without package references before automatic deletion.
enabledAtstring (date-time)TimestampoptionalMost recent enablement. Existing unused assets receive a full grace period.
pageobjectPageInfooptionalContinuation for a requested page. Absent for legacy requests.
1 field
nextCursorstringPageCursoroptionalCursor 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
repositoryIdstringRepositoryIdenabledbooleangraceDaysinteger- 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
assetIdstringRepositoryAssetIdpageobjectPageRequestoptionalBounded cursor page. Omission preserves the legacy unbounded response.
2 fields
limitintegeroptionalMaximum 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.
cursorstringPageCursoroptionalContinue the same endpoint, scope, filters, and ordering.
Response GetAssetReferencesOutput
referencesarray<object>RepositoryAssetReference5 fields
packageIdstringPackageIdpackageNamestringversionIdstringPackageVersionIdoptionalAbsent for a package-level attachment.
versionNamestringoptionalfilenamestring
pageobjectPageInfooptionalPackage attachments precede version attachments, each in stable ID order.
1 field
nextCursorstringPageCursoroptionalCursor 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
repositoryIdstringRepositoryIdID of the repository.
Response QueryRepositoryProjectsOutput
projectsarray<object>QueryRepositoryProjectsItemList of projects.
2 fields
projectIdstringProjectIdID of the project.
namestringName 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
organizationIdstringOrganizationIdoptionalOrganization to resolve path names in.
Defaults to the organization of the request. See the action for details.
repositorystringPath 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.
packagestringName 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.
repositoryIdstringRepositoryIdID of the repository.
packageIdstringPackageIdID 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
packageIdstringPackageIdID of the package.
Response GetPackageDetailsOutput
presentationobjectPackagePresentationoptionalOptional display information. Absent on older Hub versions.
3 fields
displayNamestringoptionalHuman-readable name. Absent when the URL-safe package name is used.
descriptionstringoptionalCommonMark description. Raw HTML is not rendered by the Hub UI.
imageUrlstringoptionalRoot-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.
imageLimitsobjectPackageImageLimitsoptionalImage upload limits configured by this Hub. Absent on older Hub versions.
2 fields
maxBytesintegerMaximum decoded file size in bytes.
maxDimensionintegerMaximum width and height in pixels.
packageIdstringPackageIdID of the package.
namestringName of the package.
kindstringoptionalKind of the package (e.g., "rugix-app").
versionCountinteger (64-bit)Number of versions of the package.
retentionobjectPackageVersionRetentionoptionalPackage retention policy. Absent on older Hub versions.
3 fields
enabledbooleanmaxVersionsintegeroptionalMaximum number of newest eligible versions to keep. Protected versions do not count.
- Version count must be a positive integer.
maxAgeDaysintegeroptionalMaximum age in fixed 24-hour days. This can expire every eligible version.
- Maximum age must be a positive number of days.
metadatamap<string, any>JsonValuePackage-level metadata.
assetsarray<object>PackageAssetAssets 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
assetIdstringRepositoryAssetIdfilenamestringsizeinteger (64-bit)digeststringDigeststatusstringRepositoryAssetStatus"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.
storageobjectRepositoryAssetStorageoptionalLatest 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)Timestampoptionaldetailstringoptional
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
packageIdstringPackageIdassetIdstringRepositoryAssetIdfilenamestring- Filename must be between 1 and 256 characters.
metadatamap<string, any>JsonValueoptionalOptional 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
packageIdstringPackageIdfilenamestring- 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
packageIdstringPackageIdfilenamestring- Filename must be between 1 and 256 characters.
metadatamap<string, any>JsonValueMetadata 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
presentationobjectPackagePresentationUpdateoptionalOptional initial display information.
3 fields
displayNamestringoptionalHuman-readable name. Omit to display the URL-safe package name.
- Display name must be between 1 and 128 characters.
descriptionstringoptionalCommonMark description. Raw HTML is not rendered by the Hub UI.
- Description must be at most 65536 characters.
imageobjectPackageImageUpdateoptionalOmit 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.
repositoryIdstringRepositoryIdID of the repository.
namestringName 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.
kindstringoptionalKind 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>JsonValueoptionalOptional 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.
packageIdstringPackageIdID 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
packageIdstringPackageIdpresentationobjectPackagePresentationUpdate3 fields
displayNamestringoptionalHuman-readable name. Omit to display the URL-safe package name.
- Display name must be between 1 and 128 characters.
descriptionstringoptionalCommonMark description. Raw HTML is not rendered by the Hub UI.
- Description must be at most 65536 characters.
imageobjectPackageImageUpdateoptionalOmit 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
packageIdstringPackageIdID 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
packageIdstringPackageIdID of the package.
metadatamap<string, any>JsonValueMetadata 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
packageIdstringPackageIdID of the package.
kindstringoptionalNew 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
packageIdstringPackageIdID of the package.
namestringNew 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
packageIdstringPackageIdID of the package.
filterobjectPackageVersionFilteroptionalOnly return versions matching this filter.
2 fields
releasebooleanoptionalOnly return versions with this release status.
searchstringoptionalCase-insensitive substring of the version's name, ID, or one of its tags.
pageobjectPageRequestoptionalPage to return. Without this field, the first page is returned.
2 fields
limitintegeroptionalMaximum 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.
cursorstringPageCursoroptionalContinue the same endpoint, scope, filters, and ordering.
Response QueryPackageVersionsOutput
versionsarray<object>QueryPackageVersionsItemVersions on this page.
11 fields
versionIdstringPackageVersionIdID of the package version.
namestringoptionalOptional name of the version.
createdAtstring (date-time)TimestampTimestamp when the package version was created.
deleteAtstring (date-time)TimestampoptionalExplicit deletion deadline. Package retention can delete the version earlier.
sealedbooleanoptionalSealed versions reject content changes and deletion, except by deleting their repository. Absent on older Hub versions.
releasebooleanoptionalReleases are retained indefinitely. Independent of sealing. Absent on older Hub versions.
tagsarray<object>PackageVersionTagTags of the package version.
3 fields
tagstringTag of the package version.
lockedbooleanIndicates whether the tag is locked.
assignedAtstring (date-time)TimestampoptionalTime at which the tag was assigned to the version. Absent on older Hub versions.
baseVersionIdstringPackageVersionIdoptionalVersion that a device must run before installing this version.
baseVersionNamestringoptionalOptional name of the base version.
assetCountinteger (64-bit)optionalNumber of assets of the version. Absent on older Hub versions.
assetSizeinteger (64-bit)optionalTotal size of the version's assets in bytes. Absent on older Hub versions.
pageobjectPageInfoContinuation of the traversal.
1 field
nextCursorstringPageCursoroptionalCursor 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
packageIdstringPackageIdID of the package.
filterobjectPackageTagFilteroptionalOnly return tags matching this filter.
1 field
searchstringoptionalCase-insensitive substring of the tag.
pageobjectPageRequestoptionalPage to return. Without this field, the first page is returned.
2 fields
limitintegeroptionalMaximum 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.
cursorstringPageCursoroptionalContinue the same endpoint, scope, filters, and ordering.
Response QueryPackageTagsOutput
tagsarray<object>QueryPackageTagsItemTags on this page.
5 fields
tagstringTag.
lockedbooleanIndicates whether the tag is locked.
assignedAtstring (date-time)TimestampTime at which the tag was assigned to its version.
versionIdstringPackageVersionIdID of the version the tag points to.
versionNamestringoptionalOptional name of the version the tag points to.
pageobjectPageInfoContinuation of the traversal.
1 field
nextCursorstringPageCursoroptionalCursor 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
organizationIdstringOrganizationIdoptionalOrganization to resolve path names in.
Defaults to the organization of the request. See the action for details.
repositorystringPath 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.
packagestringName 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.
tagstringTag 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.
repositoryIdstringRepositoryIdID of the repository.
packageIdstringPackageIdID of the package.
versionIdstringPackageVersionIdID 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
versionIdstringPackageVersionIdID of the package version.
Response GetPackageVersionDetailsOutput
versionIdstringPackageVersionIdID of the package version.
repositoryIdstringRepositoryIdID of the repository.
packageIdstringPackageIdID of the package.
namestringoptionalOptional name of the version.
assetsarray<object>PackageVersionAssetAssets of the version.
7 fields
filenamestringFilename of the asset.
assetIdstringRepositoryAssetIdID of the asset.
sizeinteger (64-bit)Size of the asset.
digeststringDigestDigest of the asset.
statusstringRepositoryAssetStatusStatus 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.
storageobjectRepositoryAssetStorageoptionalLatest 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)Timestampoptionaldetailstringoptional
metadatamap<string, any>JsonValueArbitrary metadata associated with this asset in the version.
tagsarray<object>PackageVersionTagTags of the version.
3 fields
tagstringTag of the package version.
lockedbooleanIndicates whether the tag is locked.
assignedAtstring (date-time)TimestampoptionalTime at which the tag was assigned to the version. Absent on older Hub versions.
metadatamap<string, any>JsonValueVersion-level metadata.
deleteAtstring (date-time)TimestampoptionalExplicit deletion deadline. Package retention can delete the version earlier.
sealedbooleanoptionalSealed versions reject content changes and deletion, except by deleting their repository. Absent on older Hub versions.
releasebooleanoptionalReleases are retained indefinitely. Independent of sealing. Absent on older Hub versions.
baseVersionIdstringPackageVersionIdoptionalVersion that a device must run before installing this version.
createdAtstring (date-time)TimestampoptionalTimestamp when the package version was created. Absent on older Hub versions.
baseVersionNamestringoptionalOptional 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
packageIdstringPackageIdID of the package.
namestringoptionalOptional name of the version.
- Version name must be between 1 and 128 characters.
deleteAtstring (date-time)TimestampoptionalEarliest 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>AddTagItemoptionalTags to add to the package version.
3 fields
tagstringTag 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.
lockedbooleanoptionalIndicates whether the tag should be locked.
Defaults to false.
reassignbooleanoptionalIndicates 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>JsonValueoptionalOptional initial metadata.
Nexigon Hub rejects metadata larger than the instance's limit, 64 KiB by default.
baseVersionIdstringPackageVersionIdoptionalVersion 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.
versionIdstringPackageVersionIdID 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
versionIdstringPackageVersionIdID 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
versionIdstringPackageVersionIddeleteAtstring (date-time)TimestampoptionalFuture 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
versionIdstringPackageVersionIdID of the package version.
namestringoptionalNew 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
versionIdstringPackageVersionIdID of the package version.
baseVersionIdstringPackageVersionIdoptionalNew 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
versionIdstringPackageVersionIdID of the package version.
metadatamap<string, any>JsonValueMetadata 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
versionIdstringPackageVersionIdID of the package version.
assetIdstringRepositoryAssetIdID of the asset.
filenamestringFilename of the asset.
- Filename must be between 1 and 256 characters.
metadatamap<string, any>JsonValueoptionalOptional 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
versionIdstringPackageVersionIdID of the package version.
filenamestringFilename 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
versionIdstringPackageVersionIdID of the package version.
filenamestringFilename of the asset.
- Filename must be between 1 and 256 characters.
metadatamap<string, any>JsonValueMetadata 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
versionIdstringPackageVersionIdID of the package version.
tagsarray<object>AddTagItemTags to add.
3 fields
tagstringTag 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.
lockedbooleanoptionalIndicates whether the tag should be locked.
Defaults to false.
reassignbooleanoptionalIndicates 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
versionIdstringPackageVersionIdID of the package version.
tagsarray<object>RemoveTagItemTags to remove.
1 field
tagstringTag 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
organizationIdstringOrganizationIdoptionalOrganization to resolve path names in.
Defaults to the organization of the request. See the action for details.
repositorystringPath 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.
packagestringName 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.
tagstringTag 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.
filenamestringFilename 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.
repositoryIdstringRepositoryIdID of the repository.
packageIdstringPackageIdID of the package.
versionIdstringPackageVersionIdID of the package version.
assetIdstringRepositoryAssetIdID 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
repositoryIdstringRepositoryIdID of the repository.
s3ConfigobjectRepositoryS3ConfigS3 config for the repository.
7 fields
endpointstringS3 endpoint (e.g., https://s3.amazonaws.com or https://minio.local:9000).
- S3 endpoint must be between 1 and 2048 characters.
- S3 endpoint must be an HTTP(S) URL.
bucketstringS3 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.
regionstringoptionalAWS region (required by AWS, may be NULL for MinIO/other providers).
- AWS region must be between 1 and 64 characters.
prefixstringoptionalOptional bucket prefix. Organization storage adds
repositories/<repository-id>/.- Bucket prefix must be at most 1024 characters.
forcePathStylebooleanoptionalForce path-style bucket addressing. By default, Nexigon uses virtual-hosted addressing.
accessKeyIdstringS3 access key ID (not sensitive, can be plain text).
- Access key ID must be between 1 and 256 characters.
secretAccessKeystringoptionalS3 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
repositoryIdstringRepositoryIdID of the repository.
Response GetRepositoryS3ConfigOutput
sourcestringRepositoryStorageSourceEffective storage source. Inherited credentials are not exposed here.
"Unconfigured""Repository""Organization"
s3ConfigobjectRepositoryS3ConfigS3 config for the repository.
7 fields
endpointstringS3 endpoint (e.g., https://s3.amazonaws.com or https://minio.local:9000).
- S3 endpoint must be between 1 and 2048 characters.
- S3 endpoint must be an HTTP(S) URL.
bucketstringS3 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.
regionstringoptionalAWS region (required by AWS, may be NULL for MinIO/other providers).
- AWS region must be between 1 and 64 characters.
prefixstringoptionalOptional bucket prefix. Organization storage adds
repositories/<repository-id>/.- Bucket prefix must be at most 1024 characters.
forcePathStylebooleanoptionalForce path-style bucket addressing. By default, Nexigon uses virtual-hosted addressing.
accessKeyIdstringS3 access key ID (not sensitive, can be plain text).
- Access key ID must be between 1 and 256 characters.
secretAccessKeystringoptionalS3 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
assetIdstringRepositoryAssetIdID of the asset.
Response GetAssetDetailsOutput
assetIdstringRepositoryAssetIdID of the asset.
sizeinteger (64-bit)Size of the asset.
digeststringDigestDigest of the asset.
statusstringRepositoryAssetStatusStatus 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.
storageobjectRepositoryAssetStorageoptionalLatest 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)Timestampoptionaldetailstringoptional
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
repositoryIdstringRepositoryIdID of the repository.
sizeinteger (64-bit)Size of the asset.
digeststringDigestDigest 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
assetIdstringRepositoryAssetIdID 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
assetIdstringRepositoryAssetIdID of the asset to issue the URL for.
filenamestringoptionalFilename under which browsers save the download, set through the
Content-Dispositionheader of the download response.- Filename must be between 1 and 256 characters.
Response IssueAssetDownloadUrlOutput
urlstringURL 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
assetIdstringRepositoryAssetIdID of the asset to issue the URL for.
Response IssueAssetUploadUrlOutput
urlstringCompatibility URL for uploading the asset without verification headers.
Objects uploaded through this URL remain dangling. New clients should use
verified_url, apply every entry inheaders, and finalize the upload.verifiedUrlstringoptionalURL for an upload whose digest and ownership Nexigon Hub can verify.
headersmap<string, string>optionalHeaders 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
assetIdstringRepositoryAssetIdID 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
pageobjectPageRequestoptionalOpt into cursor pagination. Without this field, the existing limit applies.
2 fields
limitintegeroptionalMaximum 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.
cursorstringPageCursoroptionalContinue the same endpoint, scope, filters, and ordering.
repositoryIdstringRepositoryIdID of the repository.
Response QueryAuditLogEventsOutput
pageobjectPageInfooptionalPresent when cursor pagination was requested.
1 field
nextCursorstringPageCursoroptionalCursor for the next page; absent when no more matching rows were visible.
eventsarray<object>AuditLogEventList of audit log events.
7 fields
eventIdstringAuditLogEventIdID of the audit log event.
actorobjectActorActor 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.
deviceIdstringDeviceIdID of the device.
tokenIdstringDeploymentTokenIdID of the deployment token used for authentication.
actor: "User"A user typically authenticated via a user session.
userIdstringUserIdID of the user.
actor: "UserToken"A user authenticated via a specific token.
userIdstringUserIdID of the user.
tokenIdstringUserTokenIdID of the user token used for authentication.
actor: "ClusterNode"A cluster node.
nodeIdstringClusterNodeIdID of the cluster node.
actor: "OrganizationApiToken"An organization API token.
organizationIdstringOrganizationIdID of the organization.
tokenIdstringOrganizationApiTokenIdID of the API token.
eventstringType of the event that was recorded.
dataanyJsonValueAdditional audit data associated with the event.
createdAtstring (date-time)TimestampTimestamp indicating when the audit log event was recorded.
actionobjectAuditLogEventActionoptionalAction the event has been caused by (if any).
1 field
actionIdstringAuditLogActionIdID of the action.
jobobjectAuditLogEventJoboptionalJob the event has been caused by (if any).
1 field
jobIdstringJobIdID of the job.
referencesobjectAuditLogReferencesoptionalNames of the actors of the returned events.
Absent in responses of Nexigon Hub 2026.3 and earlier.
3 fields
usersarray<object>AuditLogUserReferenceUsers acting directly or through a user token.
3 fields
userIdstringUserIdID of the user.
displayNamestringoptionalName of the user.
emailstringEmail of the user.
devicesarray<object>AuditLogDeviceReferenceDevices.
2 fields
deviceIdstringDeviceIdID of the device.
namestringName of the device.
organizationApiTokensarray<object>AuditLogOrganizationApiTokenReferenceOrganization API tokens.
2 fields
tokenIdstringOrganizationApiTokenIdID of the API token.
namestringName 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
packageIdstringPackageIdretentionobjectPackageVersionRetention3 fields
enabledbooleanmaxVersionsintegeroptionalMaximum number of newest eligible versions to keep. Protected versions do not count.
- Version count must be a positive integer.
maxAgeDaysintegeroptionalMaximum 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
versionIdstringPackageVersionIdreleaseboolean
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{}