vela push reads your local schema files, compares them against the remote API, and creates or updates schemas that have changed. Unchanged schemas are skipped.
Usage
Example output
What happens step by step
- Reads all
.json files from your schemas directory
- Fetches all existing schemas from the Vela API for your app
- Compares local vs. remote by
eventName
- Creates schemas that don’t exist remotely yet
- Updates schemas where fields, description, or metadata have changed
- Skips schemas that are identical to remote — no API call is made
Options
Error handling
If a schema fails to create or update, the error is shown inline and the CLI continues with the remaining schemas:
The exit code is 1 if any schema failed.
CI/CD deployment
Push schemas as part of your deployment pipeline, after your app code is deployed:
Run vela diff before vela push in CI to get a clear audit trail of what changed in each deployment.
Removing schemas
vela push does not delete remote schemas that have no local counterpart. Deletion must be done explicitly through the dashboard or the Management API. This is intentional — accidental file deletion should not automatically destroy production event schemas.
Dry run
To preview what vela push would do without making any changes, use vela diff instead.