Repository navigation
feat(jsm): add Atlassian Assets (Insight/CMDB) tools for asset management - #5072
Merged
Merged
Conversation
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
What
Adds nine JSM Assets (Atlassian Assets / Insight / CMDB) tools to the existing Jira Service Management integration, so workflows can read and write Atlassian Assets objects. This is the foundation for keeping JSM asset tables in sync (software/hardware asset management).
Tools
jsm_list_object_schemasGET /objectschema/listjsm_get_object_schemaGET /objectschema/{id}jsm_list_object_typesGET /objectschema/{id}/objecttypesjsm_get_object_type_attributesGET /objecttype/{id}/attributesjsm_search_objects_aqlPOST /object/aql(paginated)jsm_get_objectGET /object/{id}jsm_create_objectPOST /object/createjsm_update_objectPUT /object/{id}jsm_delete_objectDELETE /object/{id}How
cloudIdand the AssetsworkspaceId, then calls the Assets API via the OAuth 2.0 (3LO) gateway form:https://api.atlassian.com/ex/jira/{cloudId}/jsm/assets/workspace/{workspaceId}/v1/...— consistent withgetJsmApiBaseUrl.workspaceIdis discovered viaGET /rest/servicedeskapi/assets/workspace(uses the already-grantedread:servicedesk-requestscope).jira_service_managementblock (dropdown, subBlocks with conditions/required,tools.access,tool()selector,params()mapping, outputs, inputs).OAuth scopes added (
jiraprovider)read:cmdb-object:jira,write:cmdb-object:jira,delete:cmdb-object:jira,read:cmdb-schema:jira,read:cmdb-type:jira,read:cmdb-attribute:jira— each with a description inSCOPE_DESCRIPTIONS.Validation
tscclean,biomeclean,check:api-validationpasses (route baseline bumped 828→837).Notes
POST /object/aqlcarries no OAuth exclusion (unlike the removedGET /aql/objects), but a real-token check is wise.Pre-merge verification gates (do not skip)
Static validation is complete (tsc/biome/api-validation green; spec parity + internal semantics verified by multiple passes; 4 clean review rounds). The following require a live JSM+Assets instance and are not certifiable from code:
read:cmdb-object:jira(and write/delete for mutations). The 6 scope strings are verified correct and documented as OAuth 2.0 (3LO)-grantable, but enabling them on the registered app + user re-consent is an operational step.jsm_search_objects_aqlagainst a real workspace and confirmPOST /object/aqlreturns results over 3LO (the deprecatedGET /aql/objectswas OAuth-blocked; the replacement is documented as accessible, but worth one live call)./ex/jira/{cloudId}/jsm/assets/...gateway host.