Commands › › Add Revision To Sheet
Add Revision To Sheet
Coming soon
Before you run this
Active document must be open. The target revision element must exist in the project. Either sheetNumber or sheetId must be provided to resolve the target sheet.
After it runs
The revision is added to the sheet's additional revisions list. If already present, the list remains unchanged (idempotent).
When to use this
- User wants to mark a sheet as part of a specific revision issue.
- AI is updating multiple sheets with a new revision during drawing issue preparation.
Don't use this when
Creating new revisions (use Revision.Create or a dedicated CreateRevisionCommand). Removing revisions from sheets. Managing revision clouds or tags.
Inputs
| Name | Kind | Type | Required | Default | Description |
|---|---|---|---|---|---|
revisionId |
config | int |
no | — | Revision element id |
sheetNumber |
config | string |
no | — | Sheet number (preferred) |
sheetId |
config | int |
no | — | Sheet element id (optional if sheetNumber provided) |
Returns
| Name | Type | Description |
|---|---|---|
Result | JSON | Result summary with sheet and revision details |
What you'll see in the chat
on start
Adding revision to the target sheet...
Assigning the revision to your sheet now...
Assigning the revision to your sheet now...
thinking
Resolving target sheet by number or ID...
Validating revision element exists...
Updating sheet's additional revision list...
Validating revision element exists...
Updating sheet's additional revision list...
on success
Revision added to sheet {sheetNumber} successfully.
on failure
Could not add revision to sheet: {error}
REST API
Not yet exposed
This command does not carry a [RestApi] attribute today. Once tagged, this section will auto-populate with:
POST /api/v1/commands/add_revision_to_sheet- Request body schema (from
[RestApiParam]) - Response schema (from
[RestApiResponse]) - curl / JS / Python code examples
Keywords & intent patterns
add revision to sheet · apply revision to sheet · set sheet revision · sheet revision · revision on sheet
Patterns: add * revision * sheet · apply * revision * sheet · sheet * revision *
Related
| Related commands | ApplyViewTemplateCommand |
|---|---|
| Pillar |