Skip to main content

PATCH Atualizar Minha Conta

Atualiza os dados da conta (clínica) do usuário autenticado. Todos os campos são opcionais; contact e address são criados se ainda não existirem.

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

Permissão necessária

Exige a permissão read_configurations.

Sempre a conta do token

Não existe parâmetro de ID: a conta é sempre a do accountId do token autenticado.


Endpoint​

PATCH https://api-dev.imagemais.com.br/api/accounts/me

Corpo da Requisição​

CampoTipoObrigatórioDescrição
namestring❌Nome da clínica. É também o nome da organização da clínica no provedor de identidade: a mudança é gravada lá primeiro e desfeita se o banco falhar
subdomainstring❌Subdomínio de acesso (único entre as contas). De 3 a 40 caracteres: letras minúsculas, números e hífen, sem começar nem terminar em hífen e fora da lista de nomes reservados (ex.: api, app, admin, www). Vazio ou nulo não apaga o subdomínio. Em uso por outra clínica: 409 com Esse endereço já está em uso. Escolha outro.
logoInvertedboolean❌Exibir a logo em branco
contact.phonestring❌Telefone principal
contact.secondary_phonestring❌Telefone secundário
contact.emailstring❌E-mail (formato válido)
address.streetstring❌Logradouro
address.numberstring❌Número
address.districtstring❌Bairro
address.citystring❌Cidade
address.statestring❌UF
address.cepstring❌CEP
address.complementstring❌Complemento

Requisição​

curl -X 'PATCH' \
'https://api-dev.imagemais.com.br/api/accounts/me' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"name": "Clínica Exemplo",
"contact": { "phone": "(81) 3333-4444", "email": "contato@clinicaexemplo.com.br" },
"address": { "cep": "50000000", "street": "Rua Exemplo", "number": "100", "city": "Recife", "state": "PE" }
}'

Respostas​

200 Sucesso​

Retorna o registro da conta como está no banco (sem os objetos de endereço/contato — apenas os IDs).

{
"id": 1,
"name": "Clínica Fake Demo",
"logoId": 13,
"contactId": 62,
"createdAt": "2026-07-15T17:02:54.381Z",
"updatedAt": "2026-09-29T22:33:42.479Z",
"deletedAt": null,
"statusId": 1,
"expirationDate": null,
"maxUsers": 20,
"addressId": 61,
"subdomain": "app-dev",
"signatureUrl": null,
"splashSubtitle": null,
"splashTitle": null,
"brandSubtitle": null,
"loginDescription": null,
"loginTagline": null,
"logoInverted": false,
"logoutSplashSubtitle": null,
"logoutSplashTitle": null,
"auth0OrgId": null,
"workosOrgId": "org_01HXXXXXXXXXXXXXXXXXXXXXXX"
}

400 Bad Request​

Retornado quando algum campo tem tipo inválido (ex.: contact.email fora do formato).

{
"message": ["contact.O email deve ser válido"],
"error": "Bad Request",
"statusCode": 400
}