Skip to content

sync spec: drop the v2 prefix from app operation names - #105

Merged
ernestoongaro merged 1 commit into
mainfrom
sync-spec-app-operation-names
Sep 24, 2026
Merged

ernestoongaro merged 1 commit into
mainfrom
sync-spec-app-operation-names

Conversation

@ernestoongaro

Copy link
Copy Markdown
Collaborator

Summary

Syncs the spec after exploreomni/omni#65413, which removed the unneeded V2 from the app operation IDs.

Headline: renamed app commands under omni documents (paths and payloads unchanged)

before after
v2-get-app get-app
v2-get-draft-app get-draft-app
v2-get-main-draft-app get-main-draft-app
v2-put-app put-app
v2-put-app-auto-draft put-app-auto-draft
v2-patch-app patch-app
v2-patch-app-auto-draft patch-app-auto-draft
v2-remove-app remove-app

⚠️ Scripts that call the old v2-*-app command names will break. Nothing in this repo referenced them.

Also pulled in by the full sync

  • New: user-attributes create, user-attributes update <id>, user-attributes delete <id>
  • New: users delete-email-only-bulk
  • New flag: skills list --q (free-text search)
  • Schema updates to request/response bodies for AI (search docs, conversations, routines), connections, documents v2 drafts/app, schedules, and document import/export (color palettes). Body fields come in through --body, not flags.

Test plan

  • make build
  • make test
  • omni documents --help lists the eight renamed app commands
  • omni user-attributes --help shows create/update/delete; omni users --help shows delete-email-only-bulk; omni skills list --help shows --q

🤖 Generated with Claude Code

Upstream exploreomni/omni#65413 renamed the eight app operations, so the
CLI commands change from `omni documents v2-get-app` etc. to `get-app`,
`get-draft-app`, `get-main-draft-app`, `put-app`, `put-app-auto-draft`,
`patch-app`, `patch-app-auto-draft` and `remove-app`. Paths and payloads
are unchanged.

Also pulled in by the full sync:
- user-attributes create / update / delete
- users delete-email-only-bulk
- skills list --q free-text search
- response/body schema updates for AI, connections, documents v2 drafts,
  schedules, and document import/export (color palettes)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ernestoongaro

Copy link
Copy Markdown
Collaborator Author

Live verification (ernestoplayground, OAuth profile)

Renamed app commands. On a scratch app document (documents v2-create with app.html):

  • get-app: returns the published HTML and settings
  • get-main-draft-app: 404 "no main draft" before any edit; returns the draft's HTML after
  • put-app-auto-draft: creates the draft and replaces the HTML
  • patch-app-auto-draft: htmlEdits applied to the same draft
  • put-app : replaces the HTML on a named draft
  • patch-app : htmlEdits plus a settings.allowDownloads change both applied; a search that doesn't match returns 400 and nothing is applied
  • get-draft-app : shows the patched HTML and settings; after v2-publish-draft, get-app shows the same
  • remove-app : the draft then returns 404 "no app"; the published app is untouched
  • Old names are gone: omni documents v2-get-app errors with "unknown subcommand" and a suggestion

user-attributes

  • create: String attribute with a description and default_value; returns the id
  • update : label and default changed; list shows the new values
  • delete : returns {} and the attribute is gone from list; deleting it again returns 404 and exit code 1

users delete-email-only-bulk

  • Unknown emails → {"deleted":[],"notFound":{"emails":[…]}}, exit code 0
  • Unknown userIds → shows up in notFound.userIds
  • {} body → 400 "At least one email or userId must be provided"
  • Deleting a real email-only user: not tested. create-email-only and create-email-only-bulk return 403 "User-scoped API keys are not allowed to create email-only users", so this needs an org API key.

skills list --q. Tested against two scratch skills:

  • Matches name, handle and description (revenue, quarterly, cli-sync-churn)
  • Case-insensitive (REVENUE)
  • Wildcards: rev% and ch_rn match
  • Blank --q returns everything; nomatch returns 0

@ernestoongaro
ernestoongaro merged commit 9ca5ba7 into main Sep 24, 2026
2 checks passed
@ernestoongaro
ernestoongaro deleted the sync-spec-app-operation-names branch September 24, 2026 05:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants