Skip to content

SP-10: Update docs #340

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Buqeta (Buqeta) merged 2 commits into from
Apr 14, 2026
+11 −6
Merged

SP-10: Update docs #340

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
7ff8e2c
SP-X: Update docs
Buqeta Apr 14, 2026
15eb05f
SP-X: Update Skills file
Buqeta Apr 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 6 additions & 3 deletions .cursor/skills/asset-registry-endpoints/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -72,9 +72,12 @@ export_<uuid>/
### Importing packages

```bash
$CLI config import -d <export_dir> --overwrite
$CLI config import -d <export_dir> --validate --overwrite
```

- `--validate` — performs schema validations before importing. If there are
validation errors the import is **not** performed and the errors are returned.
If there are no errors, the package and its assets are imported normally.
- `--overwrite` — required when updating an existing package
- Without `--overwrite` — creates a **new** package (use for first-time import)

Expand Down Expand Up @@ -279,8 +282,8 @@ $CLI config export --packageKeys <package-key> --unzip
# — configuration root must conform to the schema from step 2
# — set spaceId to the package's space (ask the user)

# 5. Import back (--overwrite for existing package, omit for new)
$CLI config import -d <export_dir> --overwrite
# 5. Validate and import (--overwrite for existing package, omit for new)
$CLI config import -d <export_dir> --validate --overwrite
```

## Quick reference
Expand Down
8 changes: 5 additions & 3 deletions docs/user-guide/agentic-development-guide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -68,13 +68,15 @@ Add a new JSON file in the `nodes/` directory:

Set `schemaVersion` to the value from the asset descriptor's `assetSchema.version` field (returned by `asset-registry get`). The `spaceId` is required — omitting it causes import errors.

### 5. Import
### 5. Validate and import

```bash
content-cli config import -d <export_dir> --overwrite
content-cli config import -d <export_dir> --validate --overwrite
```

This creates a new version in staging (not deployed). To create a brand-new package instead of updating, omit `--overwrite`.
The `--validate` option performs schema validations for the assets. If there are no schema validations, then the package and its assets are imported. Otherwise, the validation errors are returned and the package import isn't performed.

This creates a new version in staging (not deployed) if there are no schema validation errors. To create a brand-new package instead of updating, omit `--overwrite`.

To later export a staging version, use `--keysByVersion`:

Expand Down
Loading