--- updatedAt: 2026-05-08T11:46:39.000Z agentTools: projectIndex: https://pt-developers.kommo.com/llms.txt --- # Atualizando um Lead Este método permite atualizar um único lead. Passe um objeto para atualizar um único lead. **Limitações**\ O método está disponível de acordo com os direitos do usuário. **Tipo de autorização**\ OAuth 2.0 com Token de Acesso / Token de Longa Duração **Cabeçalho de tipo de dado quando a solicitação é bem-sucedida**\ Content-Type: application/hal+json **Cabeçalho de tipo de dado em caso de erro**\ Content-Type: application/problem+json **Parâmetros de resposta**\ O método retorna uma coleção de leads criados. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "referencias-de-api-da-kommo", "version": "1.1" }, "servers": [ { "url": "https://{subdomain}.kommo.com", "variables": { "subdomain": { "default": "subdomain" } } } ], "components": { "securitySchemes": { "sec0": { "type": "oauth2", "flows": {} } } }, "security": [ { "sec0": [] } ], "paths": { "/api/v4/leads/{id}": { "patch": { "summary": "Atualizando um Lead", "description": "Este método permite atualizar um único lead. Passe um objeto para atualizar um único lead.", "operationId": "atualizando-um-lead", "parameters": [ { "name": "id", "in": "path", "description": "ID do Lead", "schema": { "type": "integer", "format": "int32" }, "required": true } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "Nome do Lead" }, "price": { "type": "number", "description": "Venda do Lead" }, "status_id": { "type": "integer", "description": "ID da Etapa à qual o Lead foi adicionado, sendo a primeira etapa do pipeline principal a padrão", "format": "int32" }, "pipeline_id": { "type": "integer", "description": "ID do Pipeline ao qual o Lead foi adicionado", "format": "int32" }, "created_by": { "type": "string", "description": "O ID do usuário que cria o Lead. Ao passar o valor 0, o lead será considerado como criado pelo robô." }, "updated_by": { "type": "integer", "description": "O ID do usuário que atualiza o Lead. Ao passar o valor 0, o lead será considerado como atualizado pelo robô.", "format": "int32" }, "created_at": { "type": "integer", "description": "A data e hora em que o lead foi criado no formato de Unix Timestamp", "format": "int32" }, "updated_at": { "type": "integer", "description": "A data e hora em que o lead foi atualizado no formato de Unix Timestamp", "format": "int32" }, "closed_at": { "type": "integer", "description": "A data e hora em que o lead foi fechado no formato de Unix Timestamp", "format": "int32" }, "loss_reason_id": { "type": "integer", "description": "ID da razão da perda", "format": "int32" }, "responsible_user_id": { "type": "integer", "description": "ID do usuário responsável pelo Lead", "format": "int32" }, "custom_fields_values": { "type": "string", "description": "Um array contendo informações sobre os valores dos campos personalizados especificados para este Lead", "format": "json" }, "_embedded": { "type": "object", "description": "Dados das tags adicionadas a um lead", "properties": { "tags": { "type": "array", "items": { "properties": { "id": { "type": "integer", "description": "ID da tag", "format": "int32" }, "name": { "type": "string", "description": "Nome da tag" } }, "type": "object" } } } }, "request_id": { "type": "string", "description": "Campo que será retornado inalterado na resposta e não será salvo." }, "tags_to_add": { "type": "array", "description": "Array de tags a serem adicionadas. Você precisa passar o nome ou o ID da tag.", "items": { "properties": { "id": { "type": "integer", "description": "ID da tag", "format": "int32" }, "name": { "type": "string", "description": "Nome da tag" } }, "type": "object" } }, "tags_to_delete": { "type": "array", "description": "Array de tags a serem deletadas. Você precisa passar o nome ou o ID da tag.", "items": { "properties": { "id": { "type": "integer", "description": "ID da tag", "format": "int32" }, "name": { "type": "string", "description": "Nome da tag" } }, "type": "object" } } } } } } }, "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Os leads foram atualizados com sucesso.": { "value": "{\n \"_links\": {\n \"self\": {\n \"href\": \"https://devteam.kommo.com/api/v4/leads\"\n }\n },\n \"_embedded\": {\n \"leads\": [\n {\n \"id\": 152464,\n \"updated_at\": 1686732474,\n \"_links\": {\n \"self\": {\n \"href\": \"https://devteam.kommo.com/api/v4/leads/152464\"\n }\n }\n }\n ]\n }\n}" } }, "schema": { "type": "object", "properties": { "_links": { "type": "object", "properties": { "self": { "type": "object", "properties": { "href": { "type": "string", "example": "https://devteam.kommo.com/api/v4/leads" } } } } }, "_embedded": { "type": "object", "properties": { "leads": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "example": 152464, "default": 0 }, "updated_at": { "type": "integer", "example": 1686732474, "default": 0 }, "_links": { "type": "object", "properties": { "self": { "type": "object", "properties": { "href": { "type": "string", "example": "https://devteam.kommo.com/api/v4/leads/152464" } } } } } } } } } } } } } } }, "400": { "description": "400", "content": { "application/json": { "examples": { "Dados inválidos fornecidos. Detalhes estão disponíveis na resposta da solicitação.": { "value": "{}" } }, "schema": { "type": "object", "properties": {} } } } }, "401": { "description": "401", "content": { "application/json": { "examples": { "Usuário não autorizado": { "value": "{\n \"title\": \"Unauthorized\",\n \"type\": \"https://httpstatus.es/401\",\n \"status\": 401,\n \"detail\": \"Nome de usuário ou senha inválidos\"\n}" } }, "schema": { "type": "object", "properties": { "title": { "type": "string", "example": "Unauthorized" }, "type": { "type": "string", "example": "https://httpstatus.es/401" }, "status": { "type": "integer", "example": 401, "default": 0 }, "detail": { "type": "string", "example": "Nome de usuário ou senha inválidos" } } } } } }, "429": { "description": "429", "content": { "text/plain": { "examples": { "Muitas requisições": { "value": "" } } } } }, "500": { "description": "500", "content": { "text/plain": { "examples": { "Erro Interno do Servidor": { "value": "" } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```