---
updatedAt: 2026-11-12T11:16:46.000Z
agentTools:
  projectIndex: https://es-developers.kommo.com/llms.txt
---

# Detener un Salesbot

Este método permite detener un Salesbot para la entidad utilizando el ID del bot.

**Encabezado de tipo de datos cuando la solicitud es exitosa**
Content-Type: text/html

**Encabezado de tipo de datos en caso de error**\
Content-Type: application/problem+json

**Parámetros de respuesta**\
Si la solicitud es exitosa, el método no retorna un cuerpo de respuesta.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "kommo-api",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://{subdominio}.kommo.com",
      "variables": {
        "subdominio": {
          "default": "subdominio"
        }
      }
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {}
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/api/v4/bots/{id}/stop": {
      "post": {
        "description": "Este método permite detener un Salesbot para la entidad utilizando el ID del bot.",
        "responses": {
          "202": {
            "content": {
              "text/html": {
                "schema": {
                  "type": "object",
                  "properties": {}
                },
                "examples": {
                  "Se han creado con éxito tareas para detener bots": {
                    "summary": "Se han creado con éxito tareas para detener bots",
                    "value": " "
                  }
                }
              }
            },
            "description": "Se han creado con éxito tareas para detener bots"
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "properties": {}
                },
                "examples": {
                  "Se transmitieron datos incorrectos. Los detalles están disponibles en el cuerpo de la respuesta.": {
                    "summary": "Se transmitieron datos incorrectos. Los detalles están disponibles en el cuerpo de la respuesta.",
                    "value": {
                      "validation-errors": [
                        {
                          "request_id": "0",
                          "errors": [
                            {
                              "code": "NotSupportedChoice",
                              "path": "entity_type",
                              "detail": "El valor seleccionado no es una opción válida."
                            }
                          ]
                        }
                      ],
                      "title": "Solicitud incorrecta",
                      "type": "https://httpstatus.es/400 ",
                      "status": 400,
                      "detail": "Falló la validación de la solicitud"
                    }
                  }
                }
              }
            },
            "description": "Se transmitieron datos incorrectos. Los detalles están disponibles en el cuerpo de la respuesta."
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "properties": {}
                },
                "examples": {
                  "Usuario no autorizado": {
                    "summary": "Usuario no autorizado",
                    "value": {
                      "title": "No autorizado",
                      "type": "https://httpstatus.es/401",
                      "status": 401,
                      "detail": "Nombre de usuario o contraseña no válidos"
                    }
                  }
                }
              }
            },
            "description": "Usuario no autorizado"
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "properties": {}
                },
                "examples": {
                  "No hay suficientes derechos para llamar a este método en la entidad especificada": {
                    "summary": "No hay suficientes derechos para llamar a este método en la entidad especificada",
                    "value": {
                      "title": "Prohibido",
                      "type": "https://httpstatus.es/403",
                      "status": 403,
                      "detail": "Permisos insuficientes"
                    }
                  }
                }
              }
            },
            "description": "No hay suficientes derechos para llamar a este método en la entidad especificada"
          }
        },
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "required": true,
            "description": "ID del Salesbot que se va a detener"
          }
        ],
        "operationId": "post_api-v4-bots-id-stop",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "entity_id": {
                    "type": "integer",
                    "format": "int32",
                    "description": "ID de la entidad para la cual se detendrá el Salesbot"
                  },
                  "entity_type": {
                    "type": "string",
                    "description": "Tipo de entidad. Puede ser `leads`"
                  }
                },
                "required": [
                  "entity_id",
                  "entity_type"
                ]
              }
            }
          }
        },
        "summary": "Detener un Salesbot"
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```