Repository navigation
Refresh Postman APIs, normalize command names, and update documentation - #10
Merged
Merged
Conversation
edumansky
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Refresh the six Postman collections and regenerate the CLI and agent skill references. Apply explicit route-based naming overrides so new APIs have stable names, duplicated flow/HDS entries are consolidated, and existing aliases retain their intended operation.
Resource operations now use
get,delete,patch, andupdatewith an ID flag. All 88 former*-idcommand names remain aliases; distinct lookup qualifiers are unchanged.API Changes
Webex Admin (
admin)webex admin archive-usersquery(GET)webex admin data-sourcesdelete— path parameters: updateddataSourceId; help/description updatedget— path parameters: updateddataSourceId; help/description updatedget-all— help/description updatedget-schema— help/description updatedget-schemas— help/description updatedregister— help/description updatedupdate— help/description updatedwebex admin identity-orgupdate-authentication-configuration-settings(PATCH)update-password-policy(PATCH)webex admin peopleupdate-person— help/description updatedwebex admin recordingsquery(POST)query-admin-compliance-officer(POST)list— help/description updatedlist-admin-compliance-officer— help/description updatedlist-group— query parameters: removedtopicwebex admin reportscreate— body fields: addedtimeZonewebex admin scim-2-usersupdate-patch— help/description updatedupdate-put— help/description updatedWebex Cloud Calling (
calling)Added group
webex calling call-controls-for-meanswer(POST)dial(POST)get(GET)hangup(POST)list(GET)Added group
webex calling metricsget-call-quality-stats(GET)Webex Contact Center (
cc)Added group
webex cc activitiesdescribe(GET)get-input-choices(GET)list-definitions(GET)webex cc address-bookdelete(DELETE)get(GET)update(PUT)delete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc agent-personal-greeting-filescreate(POST)delete(DELETE)delete-references(POST)get(GET)patch(PATCH)update(PUT)list— query parameters: updatedfilter,includeAgentDetails; help/description updatedcreate-v2-api→create(old spelling retained as an alias)delete-id-v2-api→delete(old spelling retained as an alias)delete-references-1→delete-references(old spelling retained as an alias)get-id-v2-api→get(old spelling retained as an alias)patch-id-v2-api→patch(old spelling retained as an alias)update-id-v2-api→update(old spelling retained as an alias)webex cc agent-summarieslist-2— body fields: removedagentCiUserIdwebex cc ai-featureget(GET)patch(PATCH)get-id→get(old spelling retained as an alias)patch-id→patch(old spelling retained as an alias)Added group
webex cc assetbulk-save(POST)create(POST)delete(DELETE)get(GET)list(GET)list-references(GET)patch(PATCH)update(PUT)webex cc audio-filesdelete(DELETE)get(GET)patch(PATCH)update(PUT)delete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)patch-id→patch(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc auto-csatget(GET)update(PUT)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc auxiliary-codedelete(DELETE)get(GET)update(PUT)delete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc business-hourdelete(DELETE)get(GET)update(PUT)bulk-save— help/description updatedlist— query parameters: updatedincludeCount,singleObjectResponse; help/description updateddelete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc call-monitoringwhisper-coach-request(POST)Added group
webex cc campaign-grouplist(GET)webex cc campaign-managerget-valid-times(GET)update-request— JSON body handling changedwebex cc captureslist— help/description updatedAdded group
webex cc channelbulk-save(POST)create(POST)delete(DELETE)get(GET)list(GET)list-references(GET)patch(PATCH)update(PUT)webex cc contact-list-managementupdate-status-across-campaign-chain(PATCH)get-within-campaign— path:/v3/campaign-management/campaigns/{campaignId}/contact-lists→/v4/campaign-management/campaigns/{campaignId}/contact-lists; query parameters: updatedsource; help/description updatedupdate-status-within— path parameters: updatedcontactIdwebex cc contact-numberdelete(DELETE)get(GET)update(PUT)delete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc contact-service-queuedelete(DELETE)delete-references(POST)get(GET)list-by-dynamic-skills(POST)list-by-skill-profile(GET)list-by-user-skill-profile(POST)list-manually-assignable(POST)list-references(GET)update(PUT)bulk-partial-update— help/description updatedbulk-save— help/description updatedcreate-remove-agents-users-agent— help/description updatedlist— query parameters: updatedprovisioningView,singleObjectResponse; help/description updatedlist-agent-based— help/description updatedlist-skill-based— help/description updatedlist-team-based— help/description updatedpurge-inactive— query parameters: updatednextStartId; help/description updateddelete-csq-references→delete-references(old spelling retained as an alias)delete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)list-csq-references-id→list-references(old spelling retained as an alias)list-csqs-skills-profile→list-by-dynamic-skills(old spelling retained as an alias)list-csqs-user-profile→list-by-user-skill-profile(old spelling retained as an alias)list-manually-assignable-csqs→list-manually-assignable(old spelling retained as an alias)list-skill-csqs-skill-profile→list-by-skill-profile(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc data-sourcesdelete— path parameters: updateddataSourceId; help/description updatedget— path parameters: updateddataSourceId; help/description updatedget-all— help/description updatedget-schema— help/description updatedget-schemas— help/description updatedregister— help/description updatedupdate— help/description updatedwebex cc desktop-layoutdelete(DELETE)get(GET)update(PUT)list— help/description updateddelete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc desktop-profiledelete(DELETE)get(GET)update(PUT)bulk-save— help/description updatedcreate— query parameters: addedaccessBuddyTeam,accessEntryPoint,accessIdleCode,accessQueue,accessWrapUpCode,active,addressBookId,agentAvailableAfterOutdial,agentDNValidation,agentDNValidationCriteria,agentDNValidationCriterions,agentPersonalGreeting,allowAutoWrapUpExtension,autoAcceptDigitalInteractions,autoAnswer,autoWrapAfterSeconds,autoWrapUp,buddyTeams,consultToQueue,createdTime,description,dialPlanEnabled,dialPlans,entryPoints,id,idleCodes,lastAgentRouting,lastUpdatedTime,loginVoiceOptions,manageChannelAvailability,name,organizationId,outdialANIId,outdialEnabled,outdialEntryPointId,parentType,queues,scheduleAndManageCallBack,screenPopup,showUserDetailsMS,showUserDetailsWebex,siteId,stateSynchronizationMS,stateSynchronizationWebex,systemDefault,thresholdRules,timeoutDesktopInactivityCustomEnabled,timeoutDesktopInactivityMins,version,viewableStatistics,wrapUpCodeslist— query parameters: addedprovisioningView; updatedattributes,filter,singleObjectResponse; help/description updatedpurge-inactive— query parameters: updatednextStartId; help/description updateddelete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc dial-plandelete(DELETE)get(GET)update(PUT)bulk-save— help/description updatedcreate— body fields: addedcreatedTime,lastUpdatedTime; help/description updatedlist— query parameters: updatedattributes,filter; help/description updatedlist-references— help/description updateddelete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc entry-pointdelete(DELETE)get(GET)update(PUT)delete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)Added group
webex cc eventslist-specifications(GET)Added group
webex cc external-data-updatesupdate-task-global-variables(PUT)webex cc flowdelete(DELETE)export-legacy(GET)get(GET)import-legacy(POST)lock(POST)patch-draft(PATCH)save-draft(POST)search(GET)unlock(POST)validate(POST)validate-draft(GET)export— path:/flow-store/{orgId}/project/{projectId}/flows/{flowId}:export→/{orgId}/project/{projectId}/v2/flows/{flowId}:export; query parameters: addedflowType; updatedversion; documented response code changed; help/description updatedimport— path:/flow-store/{orgId}/project/{projectId}/flows:import→/{orgId}/project/{projectId}/v2/flows:import; query parameters: updatedoverwrite; body fields: addedcontactType,description,flowName,flowType,status,version; headers: removedContent-Length; request body support changed; JSON body handling changed; documented response code changed; help/description updatedlist— path:/flow-store/{orgId}/project/{projectId}/flows→/{orgId}/project/{projectId}/flows; query parameters: addedisValidation,searchBy; updatedincludePagination; documented response code changed; help/description updatedpublish— path:/flow-store/{orgId}/project/{projectId}/flows/{flowId}:publish→/{orgId}/project/{projectId}/flows/{flowId}:publish; query parameters: addedflowType,skipValidation; documented response code changed; help/description updatedAdded group
webex cc functionscreate(POST)delete(DELETE)export(POST)get(GET)import(POST)list(GET)list-options(GET)lock(POST)publish(POST)test(POST)unlock(POST)update(PUT)webex cc generated-summariesget(GET)update(PUT)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc global-variablesdelete(DELETE)get(GET)update(PUT)delete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc holiday-listdelete(DELETE)get(GET)update(PUT)bulk-save— help/description updatedlist— query parameters: updatedincludeCount,singleObjectResponse; help/description updateddelete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc multimedia-profiledelete(DELETE)get(GET)update(PUT)delete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc notificationsubscribe— help/description updatedwebex cc outdial-anibulk-save-entries(POST)delete(DELETE)get(GET)list-entries(GET)list-entries-for-ani(GET)update(PUT)bulk-save— help/description updatedlist— query parameters: updatedsingleObjectResponse; help/description updatedbulk-save-entry→bulk-save-entries(old spelling retained as an alias)delete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)list-entry→list-entries(old spelling retained as an alias)list-entry-2→list-entries-for-ani(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc overridesdelete(DELETE)get(GET)update(PUT)list— help/description updateddelete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc realtimesubscribe-notification— help/description updatedwebex cc resource-collectiondelete(DELETE)get(GET)update(PUT)delete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)Added group
webex cc search-metadataget(GET)webex cc sitedelete(DELETE)get(GET)update(PUT)delete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc skilldelete(DELETE)get(GET)update(PUT)bulk-save— help/description updatedcreate— query parameters: removedactive,createdTime,description,dynamicSkill,enumSkillValues,id,lastUpdatedTime,name,organizationId,serviceLevelThreshold,skillType,version; body fields: addedsystemDefaultlist— query parameters: addedinclude; updatedsingleObjectResponse; help/description updatedpurge-inactive— query parameters: updatednextStartId; help/description updateddelete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc skill-profiledelete(DELETE)get(GET)update(PUT)delete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc tasksappend-message(POST)drop-participant-conference(POST)pause-digital(POST)resume-digital(POST)unhold(POST)create— body fields: addedchannelType; removedeventTime,mediaMgr,mediaType,orgId,trackingId; help/description updatedresume→unhold(old spelling retained as an alias)update-2→append-message(old spelling retained as an alias)webex cc teamdelete(DELETE)get(GET)update(PUT)bulk-save— help/description updatedlist— query parameters: updatedfilter,provisioningView,singleObjectResponse,supervisorView; help/description updatedpurge-inactive— query parameters: updatednextStartId; help/description updateddelete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)Added group
webex cc templatesget-flow(GET)list-flow(GET)Added group
webex cc usage-reportscreate(POST)delete(DELETE)download-file(GET)get(GET)list(GET)list-resource-types(GET)webex cc user-profilesdelete(DELETE)get(GET)update(PUT)list— help/description updateddelete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc usersbulk-partial-update-dynamic-skills(PATCH)get(GET)list-by-ids(POST)list-call-monitoring-id(GET)patch(PATCH)update(PUT)get-agents-matching-skill-requirements— body fields: removedcondition,createdTime,dynamicSkill,id,lastUpdatedTime,organizationId,skillId,skillName,skillType,skillValue,version,weight; JSON body handling changedget-along-profile-id— help/description updatedget-ci-id— query parameters: addedincludeSkillDetailslist— query parameters: updatedincludeAIMappingCount,queueId,singleObjectResponse; help/description updatedlist-along-profile— help/description updatedbulk-update-dynamic-skills→bulk-partial-update-dynamic-skills(old spelling retained as an alias)get-id→get(old spelling retained as an alias)get-ids→list-by-ids(old spelling retained as an alias)patch-id→patch(old spelling retained as an alias)update-id→update(old spelling retained as an alias)webex cc work-typesdelete(DELETE)get(GET)update(PUT)delete-id→delete(old spelling retained as an alias)get-id→get(old spelling retained as an alias)update-id→update(old spelling retained as an alias)Webex Device (
device)webex device device-callget-layout-id— help/description updatedupdate-layout-id— help/description updatedWebex Meetings (
meetings)webex meetings meetingslist-group(GET)patch-group(PATCH)update-group-control-status(POST)delete— help/description updatedpatch— help/description updatedupdate— help/description updatedwebex meetings peopleupdate-person— help/description updatedwebex meetings recordingsquery(POST)query-admin-compliance-officer(POST)list— help/description updatedlist-admin-compliance-officer— help/description updatedlist-group— query parameters: removedtopicWebex Messaging (
messaging)webex messaging hdsget-alarms-node(GET)get-database-config-org(GET)get-usage-node(GET)list-clusters-org(GET)list-nodes-cluster(GET)list-tenants-org(GET)get-org— help/description updatedget-database-org-2→get-database-config-org(old spelling retained as an alias)get-multi-tenant-org-2→list-tenants-org(old spelling retained as an alias)webex messaging peopleupdate-person— help/description updatedValidation
make codegen17 Python naming/route/request-generation regression tests
make check(Go build + vet)Astro site build:
node node_modules/astro/astro.js buildinsite/(the installed npm launcher currently fails to locate its ownlib/cli.js)CLI help and write dry-run routing checks
Cloverhound live GETs: paired flow list/draft/export, activity definitions, and event specifications returned identical JSON. Unprefixed templates returned 200; scoped prefixed templates returned 404.
Disposable, unpublished/unassigned Cloverhound flow: validated/imported, locked/unlocked, patched/saved through both route forms, and exported. Deleted afterward; both GET routes returned 404. No existing flow was modified.
Cloverhound 2026-10-09: refreshed activity schemas/input choices, events/templates, function metadata/options, asset/channel lists, shortened site command + old alias, Calling metrics, and recording queries succeeded. Disposable flow lifecycle and usage-report lifecycle completed with cleanup verified. Metrics returned three calls; downloaded CSR gzip passed integrity and CSV parsing (218 columns, no data rows).
Fixed a live-discovered usage-report deletion failure:
Accept: application/jsonreturned 406; endpoint-specificAccept: */*returned 204, then GET returned 404 and report list was empty.Self-service call controls returned 403; archived-user query returned gateway 404; HDS returned an explicit no-clusters response. External-data update was dry-run checked only.
Documentation
Command inventory and migration references live in
docs/.codegen/README.mddocuments generator maintenance. Personal identities, tenant test artifacts, and session test logs are excluded from repository documentation; validation results are recorded in this PR.Migration and limitations
The unsuffixed flow import/export format change is intentional: integrations using FDL must migrate to the explicit legacy commands.
functions importstill lacks multipart upload handling;flow import-legacylacks legacy upload body handling. These are documented limitations, not claimed working imports. Current-format import was live-tested. Publish and completed-task variable writes were not tenant-tested. Usage-report discovery, generation, status, gzip CSV download, deletion, and cleanup were live-tested on Cloverhound.