Skip to content

sync spec: composite-topic imported_model_ids on v2 document queries - #81

Open
dspangen wants to merge 1 commit into
mainfrom
sync-spec-imported-model-ids
Open

sync spec: composite-topic imported_model_ids on v2 document queries#81
dspangen wants to merge 1 commit into
mainfrom
sync-spec-imported-model-ids

Conversation

@dspangen

Copy link
Copy Markdown
Contributor

Summary

Syncs api/openapi.json (and the embedded cmd/omni/openapi.json) from exploreomni/omni@main (f75cae25d89).

Headline change

  • queryPresentations.data.*.query.imported_model_ids (string[]) added to the v2 document bodies — documentsV2Create, documentsV2PatchDraftBody — and to the v2 read response. These are the model IDs a query reaches through its composite topic's imports; the API authorizes the run gate on each.

Side effects pulled in by the full sync

  • models update (PATCH /api/v1/models/{modelId}): description now spells out that renaming a schema, shared, or shared-extension model requires Connection Admin, and renaming a branch requires Modeler.
  • dashboards download (POST /api/v1/dashboards/{identifier}/download): new description covering how cross-model tiles resolve (the target user when named, else the API key's user) and that tiles on unqueryable models are omitted.
  • AI routine failure code enum: no_gate removed, not_expressible added.

Command surface

No new operations, and no new query or path params — the CLI's command and flag surface is unchanged. imported_model_ids is a request-body field, so it arrives via --body rather than as a flag.

Test plan

  • make build
  • make test — all packages pass
  • ./bin/omni models update --help and ./bin/omni dashboards download --help reflect the new descriptions
  • ./bin/omni documents v2-create --schema --field queryPresentations.data.query shows imported_model_ids
  • Live API call exercising imported_model_ids (not run)

🤖 Generated with Claude Code

https://claude.ai/code/session_01UP53YBDjhQkkn3WAqMR3sf

Syncs api/openapi.json from exploreomni/omni@main (f75cae25d89).

- `queryPresentations.data.*.query.imported_model_ids` (string[]) added to
  the v2 document create/patch-draft bodies and the v2 read response. Model
  IDs the query reaches through its composite topic's imports; the API
  authorizes the run gate on each.
- `models update` description now documents the Connection Admin / Modeler
  requirements for renaming schema, shared, shared-extension, and branch
  models.
- `dashboards download` gains a description covering how cross-model tiles
  are resolved (target user, else the API key's user) and omitted when
  unqueryable.
- AI routine failure `code` enum: `no_gate` replaced by `not_expressible`.

No new operations, and no new query or path params, so the command surface
is unchanged. The new body field is reachable via
`omni documents v2-create --schema --field queryPresentations.data.query`.

Confidence: high
Scope-risk: narrow
Not-tested: live API call exercising imported_model_ids

Co-Authored-By: Claude <noreply@anthropic.com>
@dspangen
dspangen requested a review from n8agrin August 25, 2026 17:26
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.

1 participant