Skip to content

feat(kentik): add Device & Site Integration Model, source from official v6 spec - #67

Merged
michaelelrom merged 1 commit into
itential:mainfrom
michaelelrom:feat/kentik-device-site-integration-model
Aug 13, 2026
Merged

feat(kentik): add Device & Site Integration Model, source from official v6 spec#67
michaelelrom merged 1 commit into
itential:mainfrom
michaelelrom:feat/kentik-device-site-integration-model

Conversation

@michaelelrom

Copy link
Copy Markdown
Collaborator

Summary

  • Kentik's v5 REST API — the one the legacy Kentik 5.x Adapter targets — was deprecated in January 2025 with no official OpenAPI spec ever published for it. This adds a new Integration Model targeting v6 instead, Kentik's current, officially-specified, actively-supported API.
  • Combines the official Device API (v202504beta2) and Site API (v202509) specs from github.com/kentik/api-schema-public into a single Kentik Device & Site API:latest Integration Model (20 operations) — both dated originals are preserved unmodified.
  • Adds 20 CRUD workflows (Devices, Sites, Site Markets) to the existing Kentik Studio Project, backed by the new Integration Model.
  • Leaves the legacy adapter-based folders (Create Device, Device Flow Test, Sample Use Cases) untouched — Sample Use Cases is a multi-vendor reference solution spanning AWS/ServiceNow/NetBox/Teams/IAG orchestration, out of scope here, and 2 of the legacy adapter's endpoints (/api/ui/companySettings, /api/ui/devices/non-cloud-status) are undocumented internal endpoints with no v6 equivalent.
  • Rewrites Kentik/README.md to document both the new Integration Model and the retained legacy content.

Test plan

  • All 20 new workflows created and schema-validated against a running Itential Platform instance
  • Not executed against a live Kentik account (no test instance available for this pass)

…al v6 spec

Kentik's v5 REST API (targeted by the legacy Kentik 5.x Adapter) was
deprecated in January 2025 with no official spec ever published for it,
so this targets v6 instead. Combines the official Device and Site v6
specs from github.com/kentik/api-schema-public into one Integration
Model and adds 20 CRUD workflows (Devices, Sites, Site Markets) to the
existing Studio Project. The legacy adapter-based folders (Create
Device, Device Flow Test, Sample Use Cases) are left unmigrated since
they depend on undocumented internal endpoints and cross-system
orchestration outside this scope.
@michaelelrom
michaelelrom merged commit c58d51d into itential:main Aug 13, 2026
michaelelrom added a commit that referenced this pull request Aug 13, 2026
Removes the Create Device, Device Flow Test, and Sample Use Cases
folders (31 components wired to the retired adapter and its
multi-vendor sample orchestrations), leaving only the Devices/Sites/
Site Markets Integration Model workflows added in #67.

Co-authored-by: Michael Elrom <mike.elrom@itential.com>
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