Jira Service Desk API
Asked by Karthik Mohan:

I am working on automation project in Jira Service Desk - Cloud. I was looking into the API documentation and I found two sets of API documentation. I am not sure which I have to refer to, any guidance here will be appriciated

Jira Service Desk REST API:

[The Jira Service Management Cloud REST API (atlassian.com)](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk/#api-group-servicedesk)

Jira Cloud API:

[The Jira Cloud platform REST API (atlassian.com)](https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#special-request-headers)


Answers:
author: Karthik Mohan
body: Hello [@Trudy Claspill](/t5/user/viewprofilepage/user-id/3569011)

Thanks for your answer.

I am looking forward to automate things like on boarding and off boarding users to our Jira Service desk instance, and also some automation with regarding to creating tickets/requests in our service desks.


author: Trudy Claspill
body: Hello [@Karthik Mohan](/t5/user/viewprofilepage/user-id/5402677)

Welcome to the Atlassian community.

The first page link you provided is part of the REST API documentation that is specific to Jira Service Desk functionality.

The second page link you provided is part of the REST API documentation that describes APIs that are part of the general Jira Cloud platform and applicable to all the Jira products - Software, Work Management, and Service Desk.

Which one you need to refer to depends on what task you are trying to accomplish.

comments: author: Karthik Mohan
body: Hello Trudy,

Thanks for your answer.

I am trying to automate stuff like onboarding and off boarding users to our service desk projects. And User creation and deletion in the Jira and also some automation of ticket creation in the service desk projects.

I am got confused with the following scenario.

First I wanted to created a portal only user, for this Jira service desk API is useful ([The Jira Service Management Cloud REST API (atlassian.com)](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-customer/#api-rest-servicedeskapi-customer-post)). But after that I wanted to add this user to a particular service desk project which is not open. For this i am planning to use this API [The Jira Service Management Cloud REST API (atlassian.com)](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk/#api-rest-servicedeskapi-servicedesk-servicedeskid-customer-post). But in the same if i want to remove the user then I have to use [The Jira Service Management Cloud REST API (atlassian.com)](https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk/#api-rest-servicedeskapi-servicedesk-servicedeskid-customer-delete) which is still in experimental phase.

And for both adding the user, I need to fetch the account if based on the user's email, for this I need to use [The Jira Cloud platform REST API (atlassian.com).](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-users/#api-rest-api-3-user-get)

Since the Jira service management cloud rest api dosent have an api which is returns the account id of a user who is assigned to a project.


Tags: cloud

jira-software-cloud