How can I add an agent to Jira Service Desk through api?

Question

Hello,

I'm trying to add a user as an agent to my Jira Service Desk through api. I haven't found any method that does it directly, so I've searched for a method that adds users to a project. This is the one I found:

Add actors to project role

POST /rest/api/3/project/{projectIdOrKey}/role/{id}

This works until a certain point, which is where I need to add the user to a group. The problem I get is the following:

"errorMessages": [

"Si añades un usuario a los grupos seleccionados se superará la cantidad de usuarios permitidos con licencia de Jira Service Desk. Debes reducir la cantidad de usuarios con licencia o actualizar tu licencia para abarcar una mayor cantidad de usuarios."

]

Why do I get this error if I'm working with maximum 3 agents only?

Also, is there a more efficient way to add one user as an agent?

Thank you.

Eduardo_phy8ae · Answer

Hello @Daniel Eads ,

We are still waiting for a response, I will attach you some screenshots to visualize the problem we are having:

We have got 2 members in a group named A3Erp:

If we try to add the user, it works perfectly:

However, if we remove the user Carlos and try to add it again through the API, we receive the error that we commented before:

The headers added are:

Hope this information helps.

Thank you.

Eduardo_phy8ae · Answer

Hello!

Thank you for your reply. The problem we are having now is adding a user to a Jira group after adding it as an agent.

When we use the call POST /rest/api/3/project/{projectIdOrKey}/role/{id} to add the user to the Service Desk Team, we need to add the user to a group that helps us retrieving a list of users that we control. We use the call POST /rest/api/3/group/user?groupname=X to do this funcitonality, but we receive the response attached before:

{
"errorMessages": ["Si añades un usuario a los grupos seleccionados se superará la cantidad de usuarios permitidos con licencia de Jira Service Desk. Debes reducir la cantidad de usuarios con licencia o actualizar tu licencia para abarcar una mayor cantidad de usuarios."],
"errors": {}
}

We do not know why are we receiving this response because we are not adding any other users, we are only adding a user to a group. How can we add the user to the group without receiving this response?

Thank you.

Daniel Eads · Answer

Hello!

The Jira Service Desk Free plan offers a maximum of 3 agents. Knowing a bit more would be helpful:

* Are you trying to add a new user as an agent, beyond the 3 users currently in your Jira instance?
* What's the specific API call you are trying to make when you receive the error?

Generally it is easier to add agents in the web interface than using the API. The key to adding agents on a project is to put them in the Service Desk Team role though if you want to make changes directly.

If this is for a single project, I would try adding the user via the web interface and seeing if you run into the same error. Knowing the answer to the other two questions about the API will help us troubleshoot as well.

Thanks,
Daniel | Atlassian Team