Bring your own develop

learn how to integrate develop tools to as a user, you can integrate your own development tools to gain insight into your development environment this includes issues, defects, commits, and pull requests for technical services with our develop page, you can easily track the progress of your development tasks and keep a finger on the pulse of your technical services bringing data into to bring your own deploy tools complete the following steps go to the tools configuration page and navigate to the tokens tab click on create token and give a unique token name select token type as develop, then click on the create button a new entry will be added to the table in the table entry click on the vertical ellipsis icon on the respective row and select the view/regenerate token option copy that token by clicking copy icon in the token field note to post data to the apis mentioned below, add the service token (see create service token) to the authorization header of the request see the curl example for reference format step 1 token {the service token from step1} example token 74h5cr8setsjrvofkdbsisy3lsgfngu v5anur4pxu1jh8kp0nqbjhuwqsrmgztx step 2 api reference api /technical services/issues url https //{the service token from step1}/dash/api/develop/v3/technical services/issues parameters parameter type explanation example value post issues body develop issues data in json { "assignees" \[ "developer" ], "category" "bug", "created at" "2020 11 27t07 20 50 52z", "created by" "tester", "endpoint hostname" "https //github kyndryl net", "endpoint technical service id" "tech service id", "issue engine" "github", "labels" \[ "di3 0 defect" ], "priority" "high", "provider engine" "github", "href" "https //dash gravitant net/dash/api/develop/v3/issues", "provider href" "https //github kyndryl net/mcmp devops intelligence/hq/issues/1230", "provider id" "023456789", "provider url key" "1230", "severity" "sev3", "state" "open", "technical service" "testing2", "technical service override" true, "technical service tag" { "github names" "di/hq", "github org id" "93210", "github org name" "di", "github repo id" "30112", "github repo name" "hq", "github ids" "93210/30112" }, "title" "posted data from swagger", "updated at" "2022 10 27t07 20 50 52z" } curl example request curl x post \\ https //peer core gravitant net/dash/api/develop/v3/technical services/issues \\ h 'accept application/json' \\ h 'authorization token x0vqmwii93hnzfwwgi uxjniz8 clvza2i02i3u2rxw2zalmxntfogltcqse0uuz' \\ h 'content type application/json' \\ d '{ "assignees" \[ "developer" ], "category" "bug", "created at" "2022 10 27t07 20 50 52z", "created by" "tester", "endpoint hostname" "https //github kyndryl net", "endpoint technical service id" "tech id1", "issue engine" "github", "labels" \[ "di3 0 defect" ], "priority" "high", "provider engine" "github", "href" "https //dash gravitant net/dash/api/develop/v3/issues", "provider href" "https //github kyndryl net/mcmp devops intelligence/hq/issues/1233", "provider id" "023456789", "provider url key" "1233", "severity" "sev3", "state" "open", "technical service" "testing2", "technical service override" true, "technical service tag" { "github names" "di/hq", "github org id" "93210", "github org name" "di", "github repo id" "30112", "github repo name" "hq", "github ids" "93210/30112" }, "milestone due date" "2022 11 27t07 20 50 52z", "milestone name" "temp milestone", "title" "posted data from swagger", "updated at" "2022 10 22t07 20 50 52z" }' response 200 { "id" "636cd4e9f7db1c65132a4ad2", "entityid" "636cd4e9f7db1c65132a4ad2" } develop issue request body explained field data type explanation example value provider id string object id 023456789 provider href string endpoint url https //github kyndryl net/mcmp devops intelligence/hq/issues/1230 endpoint technical service id string endpoint technical service id tech service id endpoint hostname string endpoint host name https //github kyndryl net provider engine string provider engine name github provider url key string provider url id 1230 category string the develop category bug created at string date and time of issue 2020 11 27t07 20 50 52z state string state of the issue open assignees \[]string for whom issue is assigned developer technical service string technical service name is an abstraction for issue group testing2 technical service override boolean override flag for the service true api reference for pull requests api /technical services/pullrequests url https //{devops intelligence host}/dash/api/develop/v3/technical services/pullrequests this api will post the develop pull requests data to while posting the data service token is required to post the develop pull request record parameters parameter type explanation example value post pull requests body develop pull requests data in json { "created at" "2022 10 18t07 20 50 52z", "created by" "tester", "endpoint hostname" "https //github kyndryl net", "provider id" "30110", "endpoint technical service id" "12345678", "href" "https //dash gravitant net/dash/api/develop/v3/pullrequests", "pr engine" "github", "provider engine" "github", "provider href" "https //github kyndryl net/mcmp devops intelligence/hq/4001", "pull number" 4001, "state" "open", "title" "this for byod testing prs", "technical service" "di/hq", "technical service tag" { "github names" "di/hq", "github org id" "93210", "github org name" "di", "github repo id" "30112", "github repo name" "hq", "github ids" "93210/30112" }, "updated at" "2022 10 20t07 20 50 52z", "technical service override" false } curl example request curl x post \\ https //peer core gravitant net/dash/api/develop/v3/technical services/pullrequests \\ h 'accept application/json' \\ h 'authorization token x0vqmwii93hnzfwwgi uxjniz8 clvza2i02i3u2rxw2zalmxntfogltcqse0uuz' \\ h 'content type application/json' \\ d '{ "created at" "2022 10 18t07 20 50 52z", "created by" "developer", "endpoint hostname" "https //github kyndryl net", "endpoint technical service id" "mytest", "href" "https //dash gravitant net/dash/api/develop/v3/pullrequests", "pr engine" "gitlab", "provider engine" "gitlab", "provider href" "https //github kyndryl net/mcmp devops intelligence/test", "pull number" 3001, "state" "closed", "title" "this for byod testing for test", "technical service" "mcmp devops intelligence/test", "technical service tag" { "github names" "mcmp devops intelligence/test", "github org id" "93210", "github org name" "mcmp devops intelligence", "github repo id" "30000", "github repo name" "test", "github ids" "93210/30000" }, "updated at" "2022 10 19t07 20 50 52z", "technical service override" true } response 200 { "id" "636cd4e9f7db1c65132a4ad2", "entityid" "636cd4e9f7db1c65132a4ad2" } develop pr request body explained field data type explanation example value provider id string object id 30110 technical service string technical service name is an abstraction for develop pull request group di/hq provider href string endpoint url https //github kyndryl net/mcmp devops intelligence/hq/4001 endpoint technical service id string endpoint technical service id 12345678 endpoint hostname string endpoint host name https //github kyndryl net created at string date and time of pull request 2022 10 18t07 20 50 52z state string state of the pull request open pr engine string pull request engine name github pull number string pull request number 4001 technical service override boolean override flag for the service false api reference for commits api /technical services/commits url https //{devops intelligence host}/dash/api/develop/v3/technical services/commits this api will post the develop commits data to devops intelligence while posting the data service token is required to post the develop commit record parameters parameter type explanation example value post commits body develop commits data in json { "created at" "2022 10 28t07 20 50 52z", "created by" "tester", "endpoint hostname" "https //github kyndryl net", "provider id" "30110", "endpoint technical service id" "12345678", "href" "https //dash gravitant net/dash/api/develop/v3/commits", "scm engine" "github", "provider engine" "github", "provider href" "https //github kyndryl net/di/hq/84e1ad4", "commit url" "https //github kyndryl net/di/hq/84e1ad4", "sha" "84e1ad584e1ad5", "technical service" "di/hq", "technical service tag" { "github names" "di/hq", "github org id" "93210", "github org name" "di", "github repo id" "30112", "github repo name" "hq", "github ids" "93210/30112" }, "technical service override" true } curl example request curl x post \\ https //peer core gravitant net/dash/api/develop/v3/technical services/commits \\ h 'accept application/json' \\ h 'authorization token x0vqmwii93hnzfwwgi uxjniz8 clvza2i02i3u2rxw2zalmxntfogltcqse0uuz' \\ h 'content type application/json' \\ d '{ "created at" "2022 10 18t07 20 50 52z", "created by" "developer", "endpoint hostname" "https //github kyndryl net", "provider id" "301103", "endpoint technical service id" "mytest", "href" "https //dash gravitant net/dash/api/develop/v3/pullrequests", "scm engine" "githu", "provider engine" "github", "provider href" "https //github kyndryl net/mcmp devops intelligence/hq/84e1ad6", "commit url" "https //github kyndryl net/mcmp devops intelligence/hq/84e1ad6", "technical service" "mcmp devops intelligence/hq", "technical service tag" { "github names" "mcmp devops intelligence/hq", "github org id" "93210", "github org name" "mcmp devops intelligence", "github repo id" "30110", "github repo name" "hq", "github ids" "93210/30110" }, "technical service override" true }' response 200 { "id" "636cd4e9f7db1c65132a4ad2", "entityid" "636cd4e9f7db1c65132a4ad2" } develop commit request body explained field data type explanation example value provider id string object id 301103 technical service string technical service name is an abstraction for develop commit group mcmp devops intelligence/hq provider href string endpoint url https //github kyndryl net/mcmp devops intelligence/hq/84e1ad6 endpoint technical service id string endpoint technical service id mytest endpoint hostname string endpoint host name https //github kyndryl net created at string date and time of commit 2022 10 18t07 20 50 52z provider engine string provider engine name github commit url string commit endpoint url https //github kyndryl net/mcmp devops intelligence/hq/84e1ad6 technical service override boolean override flag for the service true patch api reference for issues api /technical services/issues url https //{devops intelligence host}/dash/api/develop/v3/technical services/issues this api will patch the develop issues data in devops intelligence while patching the data, service token is required to patch the develop issue record parameters parameter type explanation example value patch issues body patch issues data in json { "assignees" "albertd", "category" "bug", "issue engine" "github", "labels" "bug", "priority" "high", "provider url key" "2233", "severity" "sev3", "state" "open", "technical service" "my org/my repo", "title" "this is a bug", "updated at" "2022 11 12t07 20 50 52z" } curl example request curl x 'patch' \\ 'dash/api/develop/v3/technical services/issues' \\ h 'accept application/json' \\ h 'authorization token x0vqmwii93hnzfwwgi uxjniz8 clvza2i02i3u2rxw2zalmxntfogltcqse0uuz' \\ h 'content type application/json' \\ d '{ "assignees" "albertd", "category" "bug", "issue engine" "github", "labels" "bug", "priority" "high", "provider url key" "2233", "severity" "sev3", "state" "open", "technical service" "my org/my repo", "title" "this is a bug", "updated at" "2022 11 12t07 20 50 52z" }' response 200 { "id" "635b8ef2eddcd1cedd51f539", "unique technical service id" "635b8ef297754f22c914142e", "provider id" "9876543210", "technical service" "testing2", "technical service id" "635b9290e3bec9cf5b61ea96", "connectionid" "", "connectionname" "", "application relationships" \[], "href" "https //malathi byod gravitant net/dash/api/develop/v3/issues/1230", "service href" "", "provider href" "https //github kyndryl net/mcmp devops intelligence/hq/issues/1230", "endpoint technical service id" "tech service id", "endpoint hostname" "https //github kyndryl net", "provider engine" "github", "provider url key" "1230", "title" "patch api testing", "priority" "low", "severity" "high", "category" "other", "created at" "2022 10 30t07 20 50 52z", "updated at" "2022 11 02t07 20 50 52z", "state" "open", "issue engine" "github", "labels" null, "issue type" "", "description" "", "scmengine" "", "created by" "malathi", "assignees" \[ "malathi" ], "milestone name" "milestone1", "milestone due date" "2022 11 12t07 20 50 52z", "ismetered" true, "technical service tag" { "service unique id" "github\ https //github kyndryl net\ tech service id\ testing2", "additionalprop1" "", "additionalprop2" "", "additionalprop3" "" }, "pr details" null, "child issues" null, "is metric applicable" false, "technical service override" false } patch issue request body explained field data type explanation example value priority string priority of the issue high severity string severitu of the issue sev3 issue engine string issue engine name github provider url key string provider url id 1230 category string the develop category bug updated at string date and time of update 2022 11 12t07 20 50 52z state string state of the issue open assignees \[]string for whom issue is assigned developer technical service string technical service name is an abstraction for issue group my org/my repo title string title of the issue this is new bug patch api reference for pull requests api /technical services/pullrequests url https //{devops intelligence host}/dash/api/develop/v3/technical services/pullrequests this api will patch the develop pullrequests data in while patching the data, service token is required to patch the develop pullrequest record parameters parameter type explanation example value patch pullrequests body patch pullrequests data in json { "description" "fixing the bug related to issue 1234", "merge commit sha" "3b2e89ee3fedc08442e2e358b91447cda69c996e", "merged at" "2022 11 12t07 20 50 52z", "pr engine" "github", "pull number" 4000, "release name" "release2022 11 16", "state" "open", "technical service" "my org/my repo", "title" "this is fix for a bug", "updated at" "2022 11 12t07 20 50 52z" } curl example request curl x 'patch' \\ 'dash/api/develop/v3/technical services/pullrequests' \\ h 'accept application/json' \\ h 'authorization token x0vqmwii93hnzfwwgi uxjniz8 clvza2i02i3u2rxw2zalmxntfogltcqse0uuz' \\ h 'content type application/json' \\ d '{ "description" "fixing the bug related to issue 1234", "merge commit sha" "3b2e89ee3fedc08442e2e358b91447cda69c996e", "merged at" "2022 11 12t07 20 50 52z", "pr engine" "github", "pull number" 4000, "release name" "release2022 11 16", "state" "open", "technical service" "my org/my repo", "title" "this is fix for a bug", "updated at" "2022 11 12t07 20 50 52z" }' response 200 { "id" "635137e1729632053dc37db5", "unique technical service id" "6350f46997754f22c90a0886", "provider id" "301102", "technical service" "mcmp devops intelligence/hq", "technical service id" "6350f4c0e3bec9cf5b61ea8c", "connectionid" "", "connectionname" "", "application relationships" \[], "href" "https //malathi byod gravitant net/dash/api/develop/v3/pullrequests/4000", "service href" "", "provider href" "https //github kyndryl net/mcmp devops intelligence/hq/4000", "endpoint technical service id" "122345678", "endpoint hostname" "https //github kyndryl net", "provider engine" "gitlab", "created at" "2022 10 18t07 20 50 52z", "updated at" "2022 11 02t07 20 50 52z", "created by" "malathi", "pr engine" "gitlab", "state" "open", "title" "patch api testing", "merged at" "0001 01 01t00 00 00z", "release name" "release12", "description" "", "pull number" 4002, "ismetered" true, "ischerrypick" false, "technical service tag" { "github ids" "93210/30110", "github names" "mcmp devops intelligence/hq", "github org id" "93210", "github org name" "mcmp devops intelligence", "github repo id" "30110", "github repo name" "hq", "service unique id" "gitlab\ https //github kyndryl net 122345678\ mcmp devops intelligence/hq" }, "technical service override" false } patch pull request body explained field data type explanation example value merge commit sha string sha of commit b2e89ee3fedc08442e2e358b91447cda69c996e pr engine string pr engine name github pull number int pull request number 230 category string the develop category bug updated at string date and time of update 2022 11 12t07 20 50 52z merge at string date and time of merge 2022 11 12t07 20 50 52z state string state of the pr open assignees \[]string for whom issue is assigned developer technical service string technical service name is an abstraction for issue group my org/my repo title string title of the issue this is new pr description string description of the pr fixing the bug patch api reference for commits api /technical services/commits/{commitid} url https //{devops intelligence host}/dash/api/develop/v3/technical services/commits/{commitid} this api will patch the develop commits data in while patching the data, service token is required to commit the develop commit record parameters parameter type explanation example value commitid path commit id is the value received after posting the commit 2233c878609c251f44a1bbbb curl example request curl x 'patch' \\ 'dash/api/develop/v3/technical services/commits/635b8ef2eddcd1cedd51f539' \\ h 'accept application/json' \\ h 'authorization token x0vqmwii93hnzfwwgi uxjniz8 clvza2i02i3u2rxw2zalmxntfogltcqse0uuz' \\ h 'content type application/json' \\ d '{ "comments" "committing the fix for byod", "parent ids" "3b2e89ee3fedc08442e2e" }' response 200 { "id" "6357a9d8d1c04c9de360716f", "unique technical service id" "6352330097754f22c90c12bf", "provider id" "301103", "technical service" "mcmp devops intelligence/hq", "technical service id" "63523380e3bec9cf5b61ea90", "connectionid" "", "connectionname" "", "application relationships" \[], "href" "https //malathi byod gravitant net/dash/api/develop/v3/commits/84e1d4", "service href" "", "provider href" "https //github kyndryl net/mcmp devops intelligence/hq/84e1ad4", "endpoint technical service id" "12245678", "endpoint hostname" "https //github kyndryl net", "provider engine" "github", "sha" "", "comments" "committing the fix for byod", "created at" "2022 10 18t07 20 50 52z", "scm engine" "githu", "created by" "malathi", "commit url" "https //github kyndryl net/mcmp devops intelligence/hq/84e1ad4", "lines added" 0, "lines deleted" 0, "total lines" 0, "committer" { "committer id" "", "name" "", "email" "" }, "parent ids" null, "ismetered" true, "technical service tag" { "github ids" "93210/30110", "github names" "mcmp devops intelligence/hq", "github org id" "93210", "github org name" "mcmp devops intelligence", "github repo id" "30110", "github repo name" "hq", "service unique id" "githu\ https //github kyndryl net 12245678\ mcmp devops intelligence/hq" }, "technical service override" false } patch commits body explained field data type explanation example value comments string comments about the commit this is new commit for byod parent ids string parent ids of the commit 6357a9d8d1c04c9de360716f delete api reference for issues api /technical services/issues url https //{devops intelligence host}/dash/api/develop/v3/technical services/issues this api will delete the develop issues data from while deleting the data, service token is required to delete the develop issues record parameters parameter type explanation example value delete issues body delete issues data in json { "endpoint hostname" "https //github com", "endpoint technical service id" "my org/my repo", "provider url key" "4433" } curl example request curl x 'delete' \\ 'dash/api/develop/v3/technical services/issues' \\ h 'accept application/json' \\ h 'authorization token x0vqmwii93hnzfwwgi uxjniz8 clvza2i02i3u2rxw2zalmxntfogltcqse0uuz' \\ h 'content type application/json' \\ d '{ "endpoint hostname" "https //github com", "endpoint technical service id" "my org/my repo", "provider url key" "4433" }' response 200 "deleted successfully" delete issues body explained field data type explanation example value endpoint hostname string end point hostname https //github com endpoint technical service id string id of endpoint technical serrvice my org/my repo provider url key string issue id 4433 delete api reference for pullrequests api /technical services/pullrequests url https //{devops intelligence host}/dash/api/develop/v3/technical services/pullrequests this api will delete the develop pullrequests data from while deleting the data, service token is required to delete the develop pullrequests record parameters parameter type explanation example value delete pullrequests body delete pullrequests data in json { "endpoint hostname" "https //github com", "endpoint technical service id" "my org/my repo", "pull number" 1234 } curl example request curl x 'delete' \\ 'dash/api/develop/v3/technical services/pullrequests' \\ h 'accept application/json' \\ h 'authorization token x0vqmwii93hnzfwwgi uxjniz8 clvza2i02i3u2rxw2zalmxntfogltcqse0uuz' \\ h 'content type application/json' \\ d '{ "endpoint hostname" "https //github com", "endpoint technical service id" "my org/my repo", "pull number" 1234 }' response 200 "deleted successfully" delete pr body explained field data type explanation example value endpoint hostname string end point hostname https //github com endpoint technical service id string id of endpoint technical serrvice my org/my repo pull number int pullrequest number 1234 delete api reference for commits api /technical services/commits/{commitid} url https //{devops intelligence host}/dash/api/develop/v3/technical services/commits/{commitid} this api will delete the develop commits data from while deleting the data, service token is required to delete the develop commits record parameters parameter type explanation example value commitid path commit id is the value received after posting the commit 2233c878609c251f44a1bbbb curl example request curl x 'delete' \\ 'dash/api/develop/v3/technical services/commits/636cd4e9f7db1c65132a4ad2' \\ h 'accept application/json' \\ h 'authorization token x0vqmwii93hnzfwwgi uxjniz8 clvza2i02i3u2rxw2zalmxntfogltcqse0uuz' }' response 200 "deleted successfully"