Rechercher des utilisateurs assignables avec l'API Jira
Trouve les utilisateurs qui peuvent être assignés aux nouvelles issues d'un projet ou à une issue, avec l'accountId que prend le champ assignee. Envoyez project ou issueKey. Renvoie une liste, qui peut être plus courte que maxResults même s'il existe d'autres utilisateurs.
- Identifiant
- jira_search_assignable_users
L'appel
POST https://connect.reportei.com/api/tools/jira_search_assignable_users/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"query": "<query>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| query | string | Oui | Text matched against the start of the display name or of the email address, for example john finds John Smith. |
| project | string | Non | Project key or id, from List projects, for users assignable to its new issues. |
| issueKey | string | Non | Issue key, from Search issues, for users assignable to that issue. |
| startAt | integer | Non | Index of the first user to return. The default is 0. |
| maxResults | integer | Non | Users per page. The default is 50. |
Connexions possibles
Votre client connecte son compte Jira une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
Identifiant et mot de passe
Votre client saisit les identifiants de l'app sur un écran de Connect, ou votre système les envoie avec POST /api/customer-toolkits, sans écran.
À la connexion, votre client indique aussi {site} : l'adresse de son compte sur l'API de l'app.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/jira_search_assignable_users. Il devient la définition de tool de votre agent sans conversion.
Autres tools Jira
- Rechercher des issuesGETRecherche des issues avec JQL. La requête doit être bornée, par exemple project = KEY. Seul l'id de l'issue revient, sauf si fields liste ce qu'il faut inclure. Passez le nextPageToken de la réponse pour lire la page suivante.
- Obtenir une issueGETRenvoie une issue par id ou clé, avec tous les champs navigables, sauf si fields liste ce qu'il faut inclure.
- Créer une issuePOSTCrée une issue. fields doit contenir au moins project, issuetype et summary, et tout autre champ doit exister sur l'écran de création du projet, comme le montre Lister les champs de création. Dans cette version de l'API, le champ description prend un objet Atlassian Document Format, pas du texte brut.
- Modifier une issuePUTModifie les champs d'une issue : fields définit des valeurs, et update applique des opérations comme ajouter ou retirer un label. Un champ va dans fields ou dans update, jamais dans les deux. Le statut ne change pas ici : utilisez Faire une transition d'issue. La réponse est vide, status 204, sauf si returnIssue vaut true.
- Supprimer une issueDELETESupprime une issue. Une issue avec des sous-tâches n'est supprimée qu'avec deleteSubtasks à true, ce qui supprime aussi les sous-tâches. Exige la permission Delete issues dans le projet. La réponse est vide, status 204.
- Lister les transitionsGETListe les transitions que l'utilisateur peut effectuer maintenant sur une issue, chacune avec l'id que prend Faire une transition d'issue, son name et le statut vers lequel elle mène dans to.
- Faire une transition d'issuePOSTFait passer une issue à un autre statut en exécutant l'une de ses transitions. Quand la transition a un écran, ses champs obligatoires, comme resolution, vont dans fields ou update. La réponse est vide, status 204.
- Lister les commentairesGETListe les commentaires d'une issue, avec le corps en Atlassian Document Format. Paginez avec startAt et maxResults jusqu'à ce que startAt plus le nombre renvoyé atteigne total.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
