Skip to main content

loa publish

loa publish​

Publish a public immutable version; the web service validates self-contained resources

Publishes a public immutable version to --to org/project/asset, using an exact --version major.minor.patch. Requires authentication and permission to write to the target organization and project. Use loa auth login to configure authentication.

Creates the asset when it does not exist, inferring its type from the file extension; otherwise appends a new version. Existing version numbers are rejected and cannot be overwritten. Initial assets default to the CC_BY license unless --license is supplied. --description supplies the initial description or new-version release notes.

Self-contained validation runs in the web service for both initial publication and new versions. The CLI does not inspect or package dependencies to enforce resource closure. GLB resources must be embedded. MaterialX packages must include required textures and documents safely within the archive; built-in standard node definitions do not need to be packaged. Missing, external, or escaping required resources are rejected by the service.

Publication does not change the consuming manifest. Select the published version separately with loa add or loa update so the change can be reviewed with code. Existing administrative loa assets create and loa assets upload commands remain available.

Usage​

loa publish <file> --to <to> --version <version> [--description <description>] [--license <license>]
ArgumentTypeRequiredDescription
filestringYesFile to publish
FlagTypeRequiredDescription
--tostringYesCanonical org/project/asset ref
--versionstringYesExact major.minor.patch version
--descriptionstringNoAsset description or version release notes
--licensestringNoShare license; Choices: NONE, CC_0, CC_BY, CC_BY_SA, CC_BY_NC, CC_BY_NC_SA, CC_BY_ND, CC_BY_NC_ND

Examples​

Publish, then select the new version​

loa auth login
loa publish ./chair.glb --to acme/furniture/chair --version 3.0.0
loa add acme/furniture/[email protected] --as chair