Renommer un sujet

PATCH /api/v1/topics/{topicId} Change le nom d'un sujet. Rien d'autre ne bouge : campagnes, séquences et refus enregistrés référencent tous l'identifiant, si bien qu'un renommage n'est jamais une migration. Un nom déjà pris — sans tenir compte de la casse — répond 409, exactement comme à la création.

Autorisation

Rôle dans l'organisationCet endpoint
OWNERAutorisé
ADMINAutorisé
MEMBERRefusé — 403
Une clé porte le rôle que son créateur détient dans cette organisation — jamais un rôle sur AgentsMail lui-même. Voir Clés d'API.

Paramètres de chemin

ParamètreTypeDescription
topicIdstringObligatoire. Le sujet à renommer

Corps de la requête

ChampTypeObligatoireDescription
namestringouiDe 1 à 50 caractères
json
{"name": "agentic"}

Exemple

bash
curl -X PATCH -H "x-api-key: $AGENTMAIL_API_KEY" -H "content-type: application/json" \
  -d '{"name":"agentic"}' \
  "https://www.agentsmail.io/api/v1/topics/$TOPIC_ID"

Réponse

  • 200 OK — le sujet renommé.
  • 400 Bad Request — le nom est absent, vide ou dépasse 50 caractères ; details porte les erreurs champ par champ.
  • 401 Unauthorized — clé absente ou invalide, ou son propriétaire a quitté l'organisation.
  • 403 Forbidden — le propriétaire de la clé est member de l'organisation, pas admin.
  • 409 Conflict — un autre sujet porte déjà ce nom, casse ignorée. Rien n'a été renommé.
  • 404 Not Found — sujet inexistant, ou il appartient à une autre organisation. L'API ne confirme jamais qu'un identifiant existe à un appelant qui n'y a pas droit.
  • 429 Too Many Requests — plus de 120 requêtes en une minute pour cette clé.

Champs de la réponse

ChampTypeDescription
successbooleanIndique si l'opération a réussi
data.idstringIdentifiant unique du sujet
data.namestringSon nouveau nom
data.createdAtstringDate de création ISO
data.updatedAtstringDate ISO de la dernière modification

Exemple de réponse

json
{
  "success": true,
  "data": {
    "id": "7c2e4b19",
    "name": "agentic",
    "createdAt": "2026-03-04T08:11:00.000Z",
    "updatedAt": "2026-08-23T10:22:05.000Z"
  }
}

Remarques

  • name est le seul champ que prend cet appel. Un sujet n'a rien d'autre à modifier : on l'attache depuis la campagne ou la séquence, pas d'ici.

Voir aussi