PATCH/api/patients/{id}

Atualizar Paciente

Atualiza um paciente existente

Access Token

Para realizar requisições GET, POST, PUT, DELETE e PATCH nos endpoints da API você precisa de uma chave de autorização. Chamamos essa chave de accessToken.

Para ter acesso ao accessToken, é necessário que o usuário master da licença efetue a liberação deste pela interface do ImageMais Clinic. O accessToken tem validade de 1 hora.

Headers

Nome	Tipo	Obrig.	Descrição
`Authorization`	string	Sim	Token de autenticação no formato Bearer {accessToken}
`Content-Type`	string	Sim	Tipo de conteúdo (application/json)

AuthorizationOBRIGATÓRIO

Tipo:string

Token de autenticação no formato Bearer {accessToken}

Content-TypeOBRIGATÓRIO

Tipo:string

Tipo de conteúdo (application/json)

Parâmetros

Nome	Tipo	Obrig.	Descrição
`id`	number	Sim	ID do paciente a ser atualizado
Este parâmetro representa o ID do paciente que será utilizado na requisição. O ID é um número único que identifica cada paciente no sistema. Observação: Para encontrar o ID do paciente, para acessar a página de listar pacientes.
`name`	string	Não	Nome do paciente
Este parâmetro representa o nome do paciente que será utilizado na requisição. O nome é obrigatório e deve ser uma string válida. Atenção: Caso o campo `name` seja removido da requisição, não seja fornecido ou esteja vazio, a API retornará um erro `400 Bad Request`
`dateBirth`	string	Não	Data de nascimento do paciente (formato: YYYY-MM-DD)
Este parâmetro representa a data de nascimento do paciente. O campo é opcional e pode ser omitido na requisição sem causar erros. Formato: `dateBirth: "2000-01-01"` Atenção: Caso o campo `dateBirth` seja fornecido na requisição, ele deve estar no formato correto (YYYY-MM-DD) e ser uma data válida. Se o formato estiver incorreto ou a data for inválida, a API retornará um erro `400 Bad Request` com a mensagem: "patient.dateBirth must be a Date instance".
`gender`	string	Não	Gênero do paciente (M ou F)
Este parâmetro representa o gênero do paciente. O campo é opcional e pode ser omitido na requisição sem causar erros. Valores aceitos: `M` - Masculino `F` - Feminino Atenção: Caso o campo `gender` seja fornecido na requisição, ele deve conter um dos valores aceitos (M ou F). Se for passado um valor diferente ou inválido, a API retornará um erro `400 Bad Request`.
`rg`	string	Não	RG do paciente
`cpf`	string	Não	CPF do paciente
Este parâmetro representa o CPF do paciente. O campo é opcional e pode ser omitido na requisição sem causar erros. Observação sobre o CPF: O campo `cpf` é opcional. Caso não seja fornecido na requisição, o paciente será criado normalmente. No entanto, se o campo `cpf` for informado de forma inválida (formato incorreto, quantidade de caracteres insuficiente ou valores não numéricos), a API retornará um erro `400 Bad Request`. Atenção: Não é possível criar um paciente com o mesmo CPF. Caso seja fornecido um CPF que já existe no sistema, a API retornará um erro `409 Conflict` com a mensagem: "Já existe um paciente com esse CPF".
`address`	object	Não	Endereço do paciente (objeto com street, number, district, city, state, cep, complement)
`contact`	object	Não	Contato do paciente (objeto com phone, secondary_phone, email)

idOBRIGATÓRIO

Tipo:number

ID do paciente a ser atualizado

Este parâmetro representa o ID do paciente que será utilizado na requisição. O ID é um número único que identifica cada paciente no sistema.

Observação: Para encontrar o ID do paciente, para acessar a página de listar pacientes.

nameOPCIONAL

Tipo:string

Nome do paciente

Este parâmetro representa o nome do paciente que será utilizado na requisição. O nome é obrigatório e deve ser uma string válida.

Atenção: Caso o campo name seja removido da requisição, não seja fornecido ou esteja vazio, a API retornará um erro 400 Bad Request

dateBirthOPCIONAL

Tipo:string

Data de nascimento do paciente (formato: YYYY-MM-DD)

Este parâmetro representa a data de nascimento do paciente. O campo é opcional e pode ser omitido na requisição sem causar erros.

Formato:

dateBirth: "2000-01-01"

Atenção: Caso o campo dateBirth seja fornecido na requisição, ele deve estar no formato correto (YYYY-MM-DD) e ser uma data válida. Se o formato estiver incorreto ou a data for inválida, a API retornará um erro 400 Bad Request com a mensagem: "patient.dateBirth must be a Date instance".

genderOPCIONAL

Tipo:string

Gênero do paciente (M ou F)

Este parâmetro representa o gênero do paciente. O campo é opcional e pode ser omitido na requisição sem causar erros.

Valores aceitos:

M - Masculino
F - Feminino

Atenção: Caso o campo gender seja fornecido na requisição, ele deve conter um dos valores aceitos (M ou F). Se for passado um valor diferente ou inválido, a API retornará um erro 400 Bad Request.

rgOPCIONAL

Tipo:string

RG do paciente

cpfOPCIONAL

Tipo:string

CPF do paciente

Este parâmetro representa o CPF do paciente. O campo é opcional e pode ser omitido na requisição sem causar erros.

Observação sobre o CPF: O campo cpf é opcional. Caso não seja fornecido na requisição, o paciente será criado normalmente. No entanto, se o campo cpf for informado de forma inválida (formato incorreto, quantidade de caracteres insuficiente ou valores não numéricos), a API retornará um erro 400 Bad Request.

Atenção: Não é possível criar um paciente com o mesmo CPF. Caso seja fornecido um CPF que já existe no sistema, a API retornará um erro 409 Conflict com a mensagem: "Já existe um paciente com esse CPF".

addressOPCIONAL

Tipo:object

Endereço do paciente (objeto com street, number, district, city, state, cep, complement)

contactOPCIONAL

Tipo:object

Contato do paciente (objeto com phone, secondary_phone, email)

Request URL

https://api-dev.imagemais.com/api/patients/{id}

curl -X 'PATCH' \
  'https://api-dev.imagemais.com/api/patients/1' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOjEwLCJhY2NvdW50SWQiOjEsImlhdCI6MTc2NDk1Mzk0OCwiZXhwIjoxNzY0OTU3NTQ4LCJhdWQiOiJodHRwczovL2FwaS1kZXYuaW1hZ2VtYWlzLmNvbSIsImlzcyI6Imh0dHBzOi8vYXBwLWRldi5pbWFnZW1haXMuY29tIn0.7KsMQBlJu3i6y1x7xHfOjb9QNmiy1KN9Ir-La_b1CI4' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "João da Silva",
  "dateBirth": "2000-01-01",
  "gender": "M",
  "rg": "123456789",
  "cpf": "12345678900",
  "address": {
    "street": "Rua das Flores",
    "number": "123",
    "district": "Bairro Central",
    "city": "Recife",
    "state": "Pernambuco",
    "cep": "50000-000",
    "complement": "Apartamento 101"
  },
  "contact": {
    "phone": "string",
    "secondary_phone": "string",
    "email": "string"
  },
  "id": 1
}'

{
  "name": "João da Silva",
  "dateBirth": "2000-01-01",
  ...

{
  "name": "João da Silva",
  "dateBirth": "2000-01-01",
  "gender": "M",
  "rg": "123456789",
  "cpf": "12345678900",
  "address": {
    "street": "Rua das Flores",
    "number": "123",
    "district": "Bairro Central",
    "city": "Recife",
    "state": "Pernambuco",
    "cep": "50000-000",
    "complement": "Apartamento 101"
  },
  "contact": {
    "phone": "string",
    "secondary_phone": "string",
    "email": "string"
  },
  "id": 1
}

Respostas

{
  "id": 1,
  "name": "João da Silva",
  ...

{
  "id": 1,
  "name": "João da Silva",
  "gender": {
    "name": "M"
  },
  "dateBirth": "2000-01-01T00:00:00.000Z",
  "rg": "123456789",
  "cpf": "12345678900",
  "address": {
    "street": "Rua das Flores",
    "number": "123",
    "district": "Bairro Central",
    "city": "Recife",
    "state": "Pernambuco",
    "cep": "50000-000",
    "complement": "Apartamento 101"
  },
  "contact": {
    "phone": "string",
    "secondary_phone": "string",
    "email": "string"
  },
  "createdAt": "2025-03-07T13:30:34.227Z",
  "updatedAt": "2025-12-05T18:22:48.241Z",
  "deletedAt": null
}

{
  "message": [
    "patient.cpf must be longer than or equal to 11 characters",
  ...

{
  "message": [
    "patient.cpf must be longer than or equal to 11 characters",
    "patient.cpf must be a number string"
  ],
  "error": "Bad Request"
}

{
  "message": [
    "patient.name should not be empty",
  ...

{
  "message": [
    "patient.name should not be empty",
    "patient.name must be shorter than or equal to 200 characters",
    "patient.name must be a string"
  ],
  "error": "Bad Request"
}

{
  "message": [
    "patient.dateBirth must be a Date instance"
  ...

{
  "message": [
    "patient.dateBirth must be a Date instance"
  ],
  "error": "Bad Request"
}

{
  "message": [
    "gender must be one of the following values: M, F"
  ...

{
  "message": [
    "gender must be one of the following values: M, F"
  ],
  "error": "Bad Request"
}

{
  "message": [
    "Já existe um paciente com esse CPF"
  ...

{
  "message": [
    "Já existe um paciente com esse CPF"
  ],
  "error": "Conflict"
}

{
  "statusCode": 401,
  "message": "invalid token"
  ...

{
  "statusCode": 401,
  "message": "invalid token"
}

{
  "statusCode": 401,
  "message": "jwt expired"
  ...

{
  "statusCode": 401,
  "message": "jwt expired"
}

{
  "statusCode": 500,
  "message": "Internal server error"
  ...

{
  "statusCode": 500,
  "message": "Internal server error"
}

Atualizar Paciente

Access Token

Headers

Parâmetros

Request URL

Curl

Corpo da Requisição

Respostas