Cambiar el nombre de un tema

PATCH /api/v1/topics/{topicId} Cambia el nombre de un tema. Nada más se mueve: las campañas, las secuencias y los rechazos registrados hacen referencia al id, así que un cambio de nombre nunca es una migración. Un nombre ya usado —sin distinguir mayúsculas— responde 409, exactamente igual que en la creación.

Autorización

Rol en la organizaciónEste endpoint
OWNERPermitido
ADMINPermitido
MEMBERRechazado — 403
Una clave lleva el rol que su creador tiene en esta organización, nunca un rol sobre AgentsMail en sí. Consulta Claves de API.

Parámetros de ruta

ParámetroTipoDescripción
topicIdstringObligatorio. El tema al que se cambia el nombre

Cuerpo de la solicitud

CampoTipoObligatorioDescripción
namestringsíDe 1 a 50 caracteres
json
{"name": "agentic"}

Ejemplo

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"

Respuesta

  • 200 OK: el tema con su nuevo nombre.
  • 400 Bad Request: el nombre falta, está vacío o supera los 50 caracteres; details lleva los problemas por campo.
  • 401 Unauthorized: clave ausente o no válida, o su propietario salió de la organización.
  • 403 Forbidden: el propietario de la clave es member de la organización, no admin.
  • 409 Conflict: otro tema ya lleva ese nombre, sin distinguir mayúsculas. No se cambió ningún nombre.
  • 404 Not Found: no existe ese tema, o pertenece a otra organización. La API nunca confirma que un id existe a un llamante que no tiene derecho sobre él.
  • 429 Too Many Requests: más de 120 solicitudes en un minuto para esta clave.

Campos de la respuesta

CampoTipoDescripción
successbooleanIndica si la operación se realizó correctamente
data.idstringIdentificador único del tema
data.namestringSu nuevo nombre
data.createdAtstringFecha de creación ISO
data.updatedAtstringFecha ISO del último cambio

Ejemplo de respuesta

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

Notas

  • name es el único campo que recibe esta llamada. Un tema no tiene nada más que cambiar: asignarlo se hace desde la campaña o la secuencia, no desde aquí.

Relacionado