front_ponto_eletronico/docs/users/update.yml
2025-03-17 15:00:51 -03:00

86 lines
2.1 KiB
YAML

Atualizar usuário
---
tags:
- Users
summary: Atualiza os dados de um usuário específico
security:
- bearerAuth: []
parameters:
- in: path
name: user_id
required: true
schema:
type: integer
description: ID do usuário a ser atualizado
- in: body
name: user
required: true
schema:
type: object
properties:
username:
type: string
description: Novo nome de usuário (opcional)
email:
type: string
description: Novo email (opcional)
phone:
type: string
description: Novo telefone (opcional)
profile_image:
type: string
description: Nova URL da imagem de perfil (opcional)
birth_date:
type: string
format: date
description: Nova data de nascimento (opcional)
password:
type: string
description: Nova senha (opcional)
parent_id:
type: integer
description: ID do usuário responsável (opcional, caso queira designar um responsável para o usuário)
responses:
200:
description: Usuário atualizado com sucesso
content:
application/json:
schema:
type: object
properties:
message:
type: string
example: "Usuário atualizado com sucesso"
400:
description: Erro na atualização (exemplo.. nome de usuário já existe)
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: "Usuário com esse nome já existe"
404:
description: Usuário não encontrado
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: "Usuário não encontrado"
401:
description: Token inválido ou ausente
content:
application/json:
schema:
type: object
properties:
error:
type: string
examples:
application/json:
error: "Token inválido ou ausente"