Actualizar persona

PATCH 
/people/:id

Partial update. Only fields present in the body are written; non-writable fields (emails, phones, bank/PIX, id, workspace_id, company_id, created_at) are dropped. Requires scope finance.people.write. Sending null for an optional string field is a no-op (clearing to null is not supported via v1). The CPF/CNPJ is re-validated only when document_number / document_type actually changes — re-sending the stored value verbatim (even a legacy/invalid one) is accepted so unrelated edits aren't blocked. A document_type sent on its own is rejected with 422 when it contradicts the stored number's digit count (e.g. tagging an 11-digit number as cnpj).

Solicitud

Respuestas

200

Updated person.

400

Malformed JSON body.

401

Missing / invalid / expired / revoked token.

403

Token lacks the finance.people.write scope.

404

Person not found within the tenant (or soft-deleted).

422

Schema validation failure, invalid CPF/CNPJ check digits when the document is changed, or a type-only change that contradicts the stored number's digit count.

500

Unhandled server error.