Recevoir des e-mails : Règles
Mettre à jour une règle
Remplacez les conditions, exceptions et actions d'une règle. La position et le nombre de correspondances sont conservés.
https://g.sendcorex.com/v1command: update_ruleEnvoyez la règle entière, avec les mêmes champs que Créer une règle. Les champs manquants ne sont pas repris de l'ancienne version.
Arguments
idstringobligatoireLe
rule_id.namestringobligatoireJusqu'à 80 caractères.
conditionsobject[]obligatoireVoir Créer une règle.
actionsobject[]obligatoireVoir Créer une règle.
matchstringfacultatifallouany.exceptobject[]facultatifExceptions.
stopbooleanfacultatifArrête le traitement.
enabledbooleanfacultatifActivée ou désactivée.
timezonestringfacultatifFuseau horaire IANA.
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "update_rule",
args: {
id: "Vj0xUlVMRTAx",
name: "Clients always in Inbox",
match: "all",
conditions: [
{
field: "from_domain",
op: "in_list",
value: "acme.com, globex.com"
},
{
field: "provider",
op: "is_any_of",
value: [
"microsoft_365",
"google_workspace"
]
}
],
except: [
{
field: "subject",
op: "contains",
value: "newsletter"
}
],
actions: [
{
type: "keep_inbox"
},
{
type: "label",
value: "Clients"
},
{
type: "star"
}
],
stop: false,
timezone: "Asia/Kuala_Lumpur"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Réponse
{
"type": "SUCCESS",
"results": [
{
"command": "update_rule",
"id": "0",
"type": "SUCCESS",
"data": {
"id": "Vj0xUlVMRTAx",
"rule_id": "Vj0xUlVMRTAx",
"name": "Clients always in Inbox",
"match": "all",
"conditions": [
{
"field": "from_domain",
"op": "in_list",
"value": "acme.com, globex.com"
},
{
"field": "provider",
"op": "is_any_of",
"value": [
"microsoft_365",
"google_workspace"
]
}
],
"except": [
{
"field": "subject",
"op": "contains",
"value": "newsletter"
}
],
"actions": [
{
"type": "keep_inbox"
},
{
"type": "label",
"value": "Clients"
},
{
"type": "star"
}
],
"stop": false,
"timezone": "Asia/Kuala_Lumpur",
"enabled": true,
"position": 0,
"hits": 128,
"last_hit_at": "2026-10-25T09:12:44Z",
"created_at": "2026-10-01T02:00:00Z",
"updated_at": "2026-10-20T08:30:00Z"
}
}
]
}Erreurs
Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.
- 401
TOKEN_EXPIREDL'access token a expiré. Appelez Refresh Token et relancez la requête.
- 401
INVALID_TOKENLe token est mal formé, inconnu ou révoqué.
- 429
RATE_LIMITEDPlus de 15 requêtes/s ou 15 en cours pour la même IP + boîte aux lettres. Attendez le nombre de secondes indiqué dans Retry-After.
- CMD
INVALID_ARGSUn argument obligatoire est manquant ou invalide.
- CMD
INVALID_RULELa règle n'est pas valide. Le message indique quelle condition ou action, et pourquoi.
- CMD
NOT_FOUNDLe message, la conversation ou le dossier n'existe pas pour ce token.
- CMD
INTERNALErreur serveur. Le détail est uniquement écrit dans le log du serveur.