Check In Asset
cascade_check_inCommit working changes to a checked-out Cascade asset, saving comments to version history and releasing the lock.
Instructions
Release a checked-out Cascade asset and commit the working copy with a comment.
Completes the pair opened by cascade_check_out: the working copy becomes the new committed version, the lock is released, and the comments string is stored in the asset's version history. Must be called by the same user who performed the check-out. The asset (identified by id/path) must be currently checked out — Cascade will reject check-in of an asset that isn't locked.
Args:
identifier (object, required): The asset to check in
id (string, optional): Asset ID (preferred)
path (object, optional): { path, siteId OR siteName }
type (string, required): Entity type of the asset
comments (string, required): Description of the changes — stored in version history
Returns: Cascade OperationResult: { success: true } On failure: { success: false, message: "" }
Examples:
Use when: "Commit working changes with a note" -> { identifier: { type: "page", id: "..." }, comments: "Fixed broken links in footer." }
Don't use when: The asset isn't checked out — you'll get "Asset not checked out".
Don't use when: Someone else checked it out — only the owner can check in.
Error Handling:
"Asset not found" when the identifier doesn't resolve
"Asset not checked out" when the asset isn't currently locked
"Checked out by another user" when a different user holds the lock
"Permission denied" when credentials lack edit rights. Responses are JSON text; structuredContent is authoritative when the response fits. Oversized responses return bounded _cache metadata for cascade_read_response. For cascade_read, read_mode controls preview versus raw Cascade payload shape.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| identifier | No | The checked-out asset (or its working copy) to check back in. | |
| comments | No | REQUIRED: Check-in comments describing the changes. Empty string is allowed. |