Endpoint
PATCH /v1/companies/:id
write:companies
Envie apenas os campos que deseja alterar.
Corpo da requisição
| Campo | Tipo | Descrição |
|---|---|---|
name | string | Nome da empresa |
email | string|null | |
phone | string|null | Telefone |
website | string|null | URL do site |
document | string|null | CNPJ, com ou sem máscara (envie null para limpar) |
external_id | string|null | Identificador no seu sistema, até 100 caracteres (envie null para limpar) |
sector | string | Setor |
size | string | Tamanho: 1-10, 11-50, 51-200, 201-500, 500+ |
city | string | Cidade |
state | string | Estado |
assigned_to | string|null | ID do responsável (null para desatribuir) |
tags | string[] | Substitui completamente as tags |
custom_fields | object | Substitui completamente os campos personalizados |
Exemplo de requisição
curl -X PATCH https://api.socialsell.ai/v1/companies/664b1c2d3e4f5a6789012346 \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"size": "201-500",
"sector": "SaaS / Tecnologia",
"tags": ["enterprise", "parceiro-estratégico"]
}'
Resposta
Retorna o objeto empresa atualizado.Erros
| Código | Status | Descrição |
|---|---|---|
INVALID_ID | 400 | ID com formato inválido |
INVALID_DOCUMENT | 400 | document não tem 14 dígitos |
VALIDATION_ERROR | 400 | external_id fora do formato |
NOT_FOUND | 404 | Empresa não encontrada |
DUPLICATE_EXTERNAL_ID | 409 | O external_id já pertence a outra empresa da organização |
DUPLICATE_DOCUMENT | 409 | O CNPJ já pertence a outra empresa da organização |
COMPANY_IDENTITY_TAKEN | 409 | Nome, cidade e telefone já identificam outra empresa |