Passer au contenu principal
PATCH
Mettre à jour le statut d’une action
Fait passer une recommandation du Centre d’actions à un autre statut. Renvoyer le statut actuel ne change rien et renvoie l’action inchangée. Nécessite une offre Business, Agency Business ou Enterprise active, et un jeton d’API dont l’accès en écriture a été activé par un Propriétaire ou un Manager. Consultez Écrire des données pour l’activation, l’idempotence, les requêtes conditionnelles et la gestion des erreurs.
string
requis
Jeton bearer de votre équipe.
string
requis
La version de l’action renvoyée par Lister les actions, entre guillemets. Utilisez * pour écrire sans condition.
string
requis
Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.
string
requis
Identifiant de l’action renvoyé par Lister les actions.
string
requis
Statut cible : SUGGESTED, PENDING, IN_PROGRESS, COMPLETED, DISMISSED ou RESOLVED.

Réponse

Renvoie 200, le nouvel ETag et l’action, avec les mêmes champs que les éléments de Lister les actions plus version. La version est une valeur de concurrence opaque : copiez-la telle quelle.

Requête et réponse synthétiques

Cet exemple suppose que la version de l’action que vous avez lue en dernier est 2.

Erreurs

Consultez Codes d’erreur pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Un jeton sans accès en écriture renvoie 403 API_KEY_READ_ONLY. Sur 429, respectez Retry-After. Si le limiteur d’écriture est indisponible ou si les écritures sont suspendues, la requête renvoie 503 SERVICE_UNAVAILABLE et rien ne change.