Modifier une campagne | Documentation Prescriptio

POST /api/mcp/v1/email.campaigns.update, portée mcp:write; droits, conditions d’offre et quotas contrôlés par l’action. Même traitement que l'outil campagne_email.

exemple synthétique

curl -sS https://prescriptio.fr/api/mcp/v1/email.campaigns.update \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"campagne_id":"00000000-0000-0000-0000-000000000001"}'

{
  "campagne_id": "00000000-0000-0000-0000-000000000001"
}

Réponsegénérée depuis le schéma

{
  "action": "<campagne_modifiee>",
  "fields": {
    "cree_le": "<texte>",
    "demarre_le": "<texte>",
    "equipe_jours": 0,
    "expediteur": "<texte>",
    "expediteur_etat": "<texte>",
    "expediteur_nom": "<texte>",
    "id": "<texte>",
    "nom": "<texte>",
    "organisation_nom": "<texte>",
    "relance_jours": 0,
    "relances_max": 0,
    "repondre_a": "<texte>",
    "statut": "<texte>"
  },
  "note": "<texte>",
  "ok": null,
  "url": "<texte>"
}

Paramètres du corps

campagne_idtexterequis

UUID de la campagne. Requis partout sauf lister, creer, stats (global), desinscrits, expediteur et quota.

equipe_joursentier

Modifier : nombre de jours entre le décideur et son équipe (défaut 3). (min 0, max 30)

expediteurtexte

Creer/modifier : adresse d'expedition. Doit appartenir a un domaine verifie pour cet espace (action expediteur les liste) ou au domaine de repli de la plateforme. Laisser vide prend l'adresse par défaut de l'espace. Un domaine seulement declare est refuse : sans SPF/DKIM le message part en indesirable.

expediteur_nomtexte

Creer/modifier : le nom affiche par la messagerie du destinataire.

nomtexte

Creer/modifier : nom de la campagne (120 caracteres au plus).

relance_joursentier

Modifier : intervalle entre relances (défaut 4). (min 1, max 60)

relances_maxentier

Modifier : nombre de relances. Une campagne créée n'en a aucune (un seul envoi) : la sequence se regle ici, 1 a 3 relances. (min 0, max 3)

repondre_atexte

Creer/modifier : la boite ou arrivent les réponses (celle de l'utilisateur). Obligatoire avant de planifier.

En bref

Adresse: POST /api/mcp/v1/email.campaigns.update
Contrat: 3.0.0
Portée OAuth: mcp:write
Conditions d’accès: Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas.
Outil MCP: campagne_email : même traitement

Erreurs et quotas

Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (marches_dce, mairies_deliberations et leurs téléchargements) qui est décomptée.

Les codes HTTP, le corps d’erreur et les compteurs d’appels et de dossiers sont communs. Chaque action conserve aussi ses droits et plafonds métier : Codes d'erreur et Authentification et quotas.

Voir aussi

Référence APIL'adresse, l'authentification et les codes de réponse campagne_emailLa même action par le connecteur MCP OpenAPILe schéma machine de toutes les opérations

curl -sS https://prescriptio.fr/api/mcp/v1/email.campaigns.update \ -H 'Authorization: Bearer <jeton>' \ -H 'Content-Type: application/json' \ -d '{"campagne_id":"00000000-0000-0000-0000-000000000001"}'

{ "action": "<campagne_modifiee>", "fields": { "cree_le": "<texte>", "demarre_le": "<texte>", "equipe_jours": 0, "expediteur": "<texte>", "expediteur_etat": "<texte>", "expediteur_nom": "<texte>", "id": "<texte>", "nom": "<texte>", "organisation_nom": "<texte>", "relance_jours": 0, "relances_max": 0, "repondre_a": "<texte>", "statut": "<texte>" }, "note": "<texte>", "ok": null, "url": "<texte>" }

[Index de la documentation](https://prescriptio.fr/docs/llms.txt) # Modifier une campagne L'opération REST email.campaigns.update de Prescriptio sert à modifier les réglages d'une campagne appartenant à l'organisation. ### Exemple d'appel, synthétique **curl** ```bash curl -sS https://prescriptio.fr/api/mcp/v1/email.campaigns.update \ -H 'Authorization: Bearer <jeton>' \ -H 'Content-Type: application/json' \ -d '{"campagne_id":"00000000-0000-0000-0000-000000000001"}' ``` **Corps JSON** ```json { "campagne_id": "00000000-0000-0000-0000-000000000001" } ``` ### Forme de la réponse, générée depuis le schéma ```json { "action": "<campagne_modifiee>", "fields": { "cree_le": "<texte>", "demarre_le": "<texte>", "equipe_jours": 0, "expediteur": "<texte>", "expediteur_etat": "<texte>", "expediteur_nom": "<texte>", "id": "<texte>", "nom": "<texte>", "organisation_nom": "<texte>", "relance_jours": 0, "relances_max": 0, "repondre_a": "<texte>", "statut": "<texte>" }, "note": "<texte>", "ok": null, "url": "<texte>" } ``` ## Paramètres du corps | Nom | Type | Requis | Description | |---|---|---|---| | `campagne_id` | texte | oui | UUID de la campagne. Requis partout sauf lister, creer, stats (global), desinscrits, expediteur et quota. | | `equipe_jours` | entier | — | modifier : nombre de jours entre le décideur et son équipe (défaut 3). (min 0, max 30) | | `expediteur` | texte | — | creer/modifier : adresse d'expedition. Doit appartenir a un domaine VERIFIE pour cet espace (action expediteur les liste) ou au domaine de repli de la plateforme. Laisser vide prend l'adresse par défaut de l'espace. Un domaine seulement declare est refuse : sans SPF/DKIM le message part en indesirable. | | `expediteur_nom` | texte | — | creer/modifier : le nom affiche par la messagerie du destinataire. | | `nom` | texte | — | creer/modifier : nom de la campagne (120 caracteres au plus). | | `relance_jours` | entier | — | modifier : intervalle entre relances (défaut 4). (min 1, max 60) | | `relances_max` | entier | — | modifier : nombre de relances. Une campagne créée n'en a aucune (un seul envoi) : la sequence se regle ici, 1 a 3 relances. (min 0, max 3) | | `repondre_a` | texte | — | creer/modifier : la boite ou arrivent les réponses (celle de l'utilisateur). Obligatoire avant de planifier. | ## En bref | | | |---|---| | Adresse | `POST /api/mcp/v1/email.campaigns.update` | | Contrat | 3.0.0 | | Portée OAuth | `mcp:write` | | Conditions d’accès | Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas. | | Outil MCP | [`campagne_email`](https://prescriptio.fr/docs/api/campagne_email) : même traitement | ## Erreurs et quotas Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (`marches_dce`, `mairies_deliberations` et leurs téléchargements) qui est décomptée. Les codes HTTP, le corps d’erreur et les compteurs d’appels et de dossiers sont communs. Chaque action conserve aussi ses droits et plafonds métier : [Codes d'erreur](https://prescriptio.fr/docs/reference/erreurs) et [Authentification et quotas](https://prescriptio.fr/docs/reference/authentification#les-quotas). ## Voir aussi - [Référence API](https://prescriptio.fr/docs/reference) : L'adresse, l'authentification et les codes de réponse - [campagne_email](https://prescriptio.fr/docs/api/campagne_email) : La même action par le connecteur MCP - [OpenAPI](https://prescriptio.fr/openapi.json) : Le schéma machine de toutes les opérations