Update Asset

The update command changes an existing manifest entry without modifying the local asset file.

Bash

zeysdk update <ASSET_PATH> [options]

Parameters

Parameter	Description	Required	Example
ASSET_PATH	Asset path including class directory and filename	Yes	services/my-service.ixml

Options

Option	Description
--verbose	Show detailed output
--name <name>	Asset name
--type <type>	Service or weblet type; case-insensitive
--view <view>	Weblet view
--entity <entity>	Entity for an entity-triggered service
--schedule <minutes>	TIMING start time as an integer from 0 to 1439
--interval <minutes>	TIMING interval as an integer of at least 1
--public <value>	Resource public flag (0 or 1)
--url <url>	Empty or an http:///https:// URL for a weblet or service
--accesskey <key>	HTTP access key for REMOTECALL services
--width <pixels>	Popup or embedded weblet width; non-negative integer
--height <pixels>	Popup or embedded weblet height; non-negative integer
--svgpath <path>	SVG path for an INTEGRATED, STANDALONE, or DETACHED icon
--color <hex>	Three or six uppercase hex digits without #
--langaliases <json>	Language aliases as valid JSON text; an empty value stores null

Any metadata flag selects non-interactive mode and merges applicable values over the existing entry. With no metadata flags, services, resources, and weblets use interactive prompts. Generic assets preserve their existing content and have no editable metadata prompts.

Validation and Behavior

1. Requires zeyos.app.json and an existing asset key.
2. Rejects absolute paths, traversal, symbolic-link path components, and invalid characters.
3. For services, resources, and weblets, requires the supplied extension to match the MIME type registered in the manifest. Use rename to change an extension.
4. Validates type-specific metadata, then rewrites only the selected manifest entry. The local file contents are not read or changed.

Service and weblet types are the same as for add. Type flags are normalized to uppercase. Entity-triggered services require an entity; --schedule and --interval enforce the documented TIMING ranges. Popup and embedded weblets use dimensions, while integrated, standalone, and detached weblets use SVG path and color.

Service Types

Type	Description	Schedule	Interval
TIMING	Scheduled task	Minutes from midnight (0-1439)	Integer of at least 1
REMOTECALL	External API call	N/A	N/A
AFTER_CREATION	Post-create hook	N/A	N/A
BEFORE_MODIFICATION	Pre-update hook	N/A	N/A
AFTER_MODIFICATION	Post-update hook	N/A	N/A
AFTER_CREATION_MODIFICATION	Combined hook	N/A	N/A
BEFORE_DELETION	Pre-delete hook	N/A	N/A
AFTER_DELETION	Post-delete hook	N/A	N/A

Weblet Types

Type	Description	Width/Height
INTEGRATED	In-app weblet	Not used
STANDALONE	Independent window	Not used
DETACHED	Floating window	Not used
POPUP_FRAMED	Modal with frame	Non-negative integers
POPUP_PLAIN	Modal without title	Non-negative integers
EMBEDDED_FRAMED	Inline with frame	Non-negative integers
EMBEDDED_COLLAPSED	Collapsible panel	Non-negative integers
EMBEDDED_PLAIN	Inline without frame	Non-negative integers

Examples

Bash

# Change a timing interval while preserving other service metadata
zeysdk update services/daily-backup.ixml --interval 720

# Change a service type; entity hooks require an entity
zeysdk update services/contact-hook.ixml \
  --type AFTER_MODIFICATION --entity contacts

# Change a weblet to an integrated type with icon metadata
zeysdk update weblets/customer-view.ixml \
  --type INTEGRATED --view customers.index \
  --color 4287F5 --svgpath 'M10 10h100v100h-100z'

# Update resource metadata
zeysdk update resources/company-logo.png \
  --name "Company Brand Logo" --public 1

# Clear optional values explicitly
zeysdk update services/remote-call.ixml --url '' --accesskey ''
zeysdk update weblets/customer-view.ixml --langaliases ''

Error Handling

Error	Description	Resolution	Example
Invalid asset class	Unsupported type	Use correct class	services/backup.ixml not service/backup.ixml
Missing app.json	Config file not found	Initialize app	Run zeysdk create first
Asset not found	Asset doesn't exist	Create asset	Run zeysdk add first
Invalid filename	Bad characters or unsafe path	Keep the path inside its asset directory	Use services/backup-daily.ixml
Extension mismatch	Path extension differs from the registered MIME type	Use the registered filename or rename	Do not update a .png resource as .jpg
Invalid type	Wrong service/weblet type	Use valid type	Use TIMING not SCHEDULED
Invalid schedule	Not an integer from 0 to 1439	Use minutes from midnight	Use 1410 for 23:30
Invalid interval	Not an integer of at least 1	Use a positive minute count	Use 1440 for daily
Invalid dimensions	Not a non-negative integer	Use pixels without units	Use 800 not 800px
Invalid color	Includes #, lowercase, or wrong length	Use 3 or 6 uppercase hex digits	Use 4287F5

Notes

• update changes metadata, not the asset file contents
• Service and weblet prompts depend on the selected type.
• Resource visibility is controlled by the public metadata field
• Use zeysdk compare after updates to review pending metadata changes
• Empty strings can clear optional URL, access-key, view, icon, and language-alias values where applicable.