Atribuir um Practitioner a um Usuário

Descrição

Este endpoint atribui um usuário com papel "Master Practitioner" (role_id = 5) ou "Practitioner" (role_id = 7) como responsável por outro usuário, atualizando o campo parent_id no banco de dados.

Verbo

POST

URL Base

https://api.soargi.com

Endpoint

/users/assign-practitioner/{user_id}

Cabeçalhos

Parâmetro Valor
Authorization Bearer Token
Content-Type application/json

Campos Esperados

Campo Tipo Obrigatório Descrição
practitioner_id int Sim ID do usuário Master Practitioner ou Practitioner.

Corpo da Requisição

{ 
    "practitioner_id": 8
}

Observação: O corpo da requisição deve ser enviado como JSON no formato raw.

Respostas

Sucesso - 201

{
    "success": true,
    "message": "Responsible assigned successfully.",
    "user_id": 12,
    "practitioner_id": 8
}

Erro - 400 (Dados inválidos ou campos ausentes)

{
    "status": 400,
    "error": 400,
    "messages": {
        "error": "The specified practitioner is invalid."
    }
}
{
    "status": 400,
    "error": 400,
    "messages": {
        "error": "practitioner_id is required."
    }
}

Erro - 404 (Usuário não encontrado)

{
    "status": 404,
    "error": 404,
    "messages": {
        "error": "User not found."
    }
}

Erro - 500 (Practitioner não informado)

{
    "status": 500,
    "error": 500,
    "messages": {
        "error": "Failed to assign practitioner."
    }
}

Códigos de Resposta

  • 201 - Usuário criado com sucesso
  • 400 - Dados inválidos ou campos ausentes
  • 404 - Usuário não encontrado
  • 500 - Practitioner não informado