Atualizar pessoa

PUT

https://api.cubosuite.com.br/peoples/{id}

Descrição

Atualiza os dados de uma pessoa associada à empresa do usuário autenticado, incluindo campos personalizados.

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.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Path

Parâmetros Header

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.cubosuite.com.br/peoples/1374331' \
--header 'Authorization: Bearer <token>' \
--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 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"
        }
    ]
}

Modificado em 2025-06-23 14:25:15

Atualizar pessoa

Descrição#

Campos opcionais#

Requisição

Respostas

Descrição

Campos opcionais