v1Ressources/Approvals/postApprove an item
Approve an item
Approves a pending item and runs it. For held content you can approve it anyway after reviewing its content checks, give it a new send time, or record a reason. Answers 409 when it was already decided, and 502 when it was approved but the action failed.
post
approvals:write/api/v1/approvals/{id}/approveParamètres de requête
idstringobligatoire
Corps de la requête
reasonstringfacultatif
Why you approved or declined it, up to 2,000 characters. It is kept with the decision.
scheduledForstringfacultatif
A new time to publish content at, as a date-time. Leave it out to keep the time the item already has.
anywayobjectfacultatif
Approve content even though its content checks flagged it: send the fingerprint of the check result you reviewed and the keys of the findings you accept.
fingerprintstringfacultatif
acceptedKeysarray of stringfacultatif
Réponse
dataobjectfacultatif
idstringfacultatif
statusstring (pending | approved | rejected)facultatif
kindstringfacultatif
What kind of item this is, for example content your agent drafted or an action held by your autonomy rules.
originstringfacultatif
titlestringfacultatif
summarystringfacultatif
clientIdstringfacultatif
modulestringfacultatif
changeobjectfacultatif
The exact action that runs on approval: the tool, its arguments and the fields it changes.
toolstringfacultatif
argsobjectfacultatif
fieldsarray of objectfacultatif
contentobjectfacultatif
The drafted content, when the item is content.
requestedAtstringfacultatif
scheduledForstringfacultatif
expiresAtstringfacultatif
decidedAtstringfacultatif
decidedBystringfacultatif
Who made the decision, or null while it is still pending.
decisionReasonstringfacultatif
publishStatestring (published | failed)facultatif
publishErrorstringfacultatif
publishedAtstringfacultatif
Erreurs
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
409La requête entre en conflit avec l'état actuel de la ressource — par exemple, modifier l'e-mail ou le téléphone d'un destinataire à qui un message a déjà été envoyé, ou une invitation d'équipe déjà acceptée (ou pas encore acceptée).
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
502The item was approved but the action failed to run. The error says why.
post/api/v1/approvals/{id}/approve
Votre clé API
id *
Corps de la requête
{}