Atualizar pessoa
PUT
https://api.cubosuite.com.br/peoples/{id}
Descrição
Campos opcionais
| Campo | Tipo | Descrição |
|---|---|---|
| name | string | Nome da pessoa. |
| phone | string | null | Número de telefone. Será normalizado para conter apenas dígitos. |
| organizationId | number | null | ID da organização relacionada (deve pertencer à empresa do usuário). |
| status | enum | Status da pessoa. Valores possíveis: active, deactivated. |
| customfields | array de objetos | Lista de campos personalizados (contexto: Pessoas). |
| customfields[].customfieldId | number | ID do campo personalizado. |
| customfields[].value | string | Valor do campo personalizado. |
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://api.cubosuite.com.br/peoples/1374331' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "João da Silva",
"phone": "(11) 91234-5678",
"organizationId": 864,
"status": "active",
"customfields": [
{
"customfieldId": 311799,
"value": "Cliente desde 2022"
}
]
}'Response Response Example
{
"id": 1374317,
"name": "João da Silva",
"phone": "11912345678",
"organizationId": 864,
"userId": 52,
"companyId": 1,
"status": "active",
"createdAt": "2025-06-23T11:18:26.000-03:00",
"updatedAt": "2025-06-23T11:23:33.293-03:00",
"token": null,
"normalizedPhone": "11912345678",
"organization": {
"id": 864,
"name": "Prospecta",
"status": "active",
"companyId": 1,
"userId": 52,
"createdAt": "2021-10-21T19:04:08.000-03:00",
"updatedAt": null
},
"deals": [],
"annotations": [
{
"dealId": null,
"organizationId": null,
"peopleId": 1374317,
"activityId": null,
"id": 7364921,
"text": "Pessoa criada",
"userId": 52,
"type": "alteration",
"createdAt": "2025-06-23T11:18:26.000-03:00",
"updatedAt": "2025-06-23T11:18:26.000-03:00"
},
{
"dealId": null,
"organizationId": null,
"peopleId": 1374317,
"activityId": null,
"id": 7364989,
"text": "Nome: João da Silva → João da Silva",
"userId": 52,
"type": "alteration",
"createdAt": "2025-06-23T11:23:33.000-03:00",
"updatedAt": "2025-06-23T11:23:33.000-03:00"
},
{
"dealId": null,
"organizationId": null,
"peopleId": 1374317,
"activityId": null,
"id": 7364990,
"text": "Telefone: 11912345678 → 11912345678",
"userId": 52,
"type": "alteration",
"createdAt": "2025-06-23T11:23:33.000-03:00",
"updatedAt": "2025-06-23T11:23:33.000-03:00"
},
{
"dealId": null,
"organizationId": null,
"peopleId": 1374317,
"activityId": null,
"id": 7364991,
"text": "Organização: Organização não encontrada → Prospecta",
"userId": 52,
"type": "alteration",
"createdAt": "2025-06-23T11:23:33.000-03:00",
"updatedAt": "2025-06-23T11:23:33.000-03:00"
},
{
"dealId": null,
"organizationId": null,
"peopleId": 1374317,
"activityId": null,
"id": 7364992,
"text": "Nova info: Sem informação → Cliente desde 2022",
"userId": 52,
"type": "alteration",
"createdAt": "2025-06-23T11:23:33.000-03:00",
"updatedAt": "2025-06-23T11:23:33.000-03:00"
}
],
"customfields": [
{
"id": 305054,
"peopleId": 1374317,
"customfieldId": 311799,
"value": "Cliente desde 2022",
"createdAt": "2025-06-23T11:23:33.000-03:00",
"updatedAt": "2025-06-23T11:23:33.000-03:00"
}
]
}Requisição
Parâmetros Path
id
string
requerido
Exemplo:
1374331
Parâmetros Header
Content-Type
string
opcional
Exemplo:
application/json
Parâmetros Bodyapplication/json
Respostas
Modificado em 2025-06-23 14:25:15