POST/api/procedure-doctors/{procedure_id}/doctors

Habilitar médico

Habilita um médico da clínica para este procedimento.

Exige o token de acesso — como obter
Permissão “Editar procedimento” (procedures.edit)

Headers

Nome	Tipo	Obrig.	Descrição
`Authorization`	string	Sim	Bearer {access_token}, com o token que o login devolve.
`Content-Type`	string	Sim	application/json

Parâmetros do caminho

Nome	Tipo	Obrig.	Descrição
`procedure_id`	uuid	Sim	O procedimento.

Corpo da requisição

Nome	Tipo	Obrig.	Descrição
`doctor_id`	uuid	Sim	O médico: um usuário da clínica com a função medico.

Campos da resposta

Nome	Tipo	Descrição
`id`	uuid	A habilitação.
`procedure_id`	uuid	O procedimento.
`doctor_id`	uuid	O médico (o id do usuário dele).
`name`	string	Nome do médico.
`email`	string	E-mail do médico.
`crm`	string \| null	CRM, do perfil do médico.
`specialty`	string \| null	Especialidade, do perfil do médico.
`created_at`	string	Quando foi habilitado (ISO 8601).

Request URL

https://api-endosystem.imagemais.com.br/api/procedure-doctors/3c1e9a7b-2d4f-4b6a-8e0c-5f7a9b1c3d2e/doctors

curl -X POST "https://api-endosystem.imagemais.com.br/api/procedure-doctors/3c1e9a7b-2d4f-4b6a-8e0c-5f7a9b1c3d2e/doctors" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"doctor_id":"5f0c8a52-3b1e-4f7a-9c2d-1a6e7b8c9d01"}'

{
  "doctor_id": "5f0c8a52-3b1e-4f7a-9c2d-1a6e7b8c9d01"
}

{
  "doctor_id": "5f0c8a52-3b1e-4f7a-9c2d-1a6e7b8c9d01"
}

Respostas

{
  "id": "2e4f6a8b-0c1d-4e3f-a5b7-c9d1e3f5a7b9",
  "procedure_id": "3c1e9a7b-2d4f-4b6a-8e0c-5f7a9b1c3d2e",
  ...

{
  "id": "2e4f6a8b-0c1d-4e3f-a5b7-c9d1e3f5a7b9",
  "procedure_id": "3c1e9a7b-2d4f-4b6a-8e0c-5f7a9b1c3d2e",
  "doctor_id": "5f0c8a52-3b1e-4f7a-9c2d-1a6e7b8c9d01",
  "name": "Dra. Ana Souza",
  "email": "ana.souza@clinica.com.br",
  "crm": "12345-PE",
  "specialty": "Radiologia e Diagnóstico por Imagem",
  "created_at": "2026-09-02T10:30:00-03:00"
}

{
  "error": "doctor_id é obrigatório"
}

{
  "error": "doctor_id é obrigatório"
}

{
  "error": "Médico já habilitado para este procedimento"
}

{
  "error": "Médico já habilitado para este procedimento"
}

{
  "error": "Médico não encontrado"
}

{
  "error": "Médico não encontrado"
}

{
  "error": "Procedimento não encontrado"
}

{
  "error": "Procedimento não encontrado"
}

{
  "error": "Você não tem a permissão \"Editar procedimento\".",
  "code": "sem_permissao"
  ...

{
  "error": "Você não tem a permissão \"Editar procedimento\".",
  "code": "sem_permissao"
}

{
  "error": "Funcionalidade não contratada",
  "message": "Esta funcionalidade não está habilitada para a sua clínica.",
  ...

{
  "error": "Funcionalidade não contratada",
  "message": "Esta funcionalidade não está habilitada para a sua clínica.",
  "code": "FEATURE_NOT_ENABLED"
}

{
  "error": "Token ausente",
  "message": "Token de autenticação necessário.",
  ...

{
  "error": "Token ausente",
  "message": "Token de autenticação necessário.",
  "code": "TOKEN_MISSING"
}

{
  "error": "Token expirado",
  "message": "Sua sessão expirou. Faça login novamente.",
  ...

{
  "error": "Token expirado",
  "message": "Sua sessão expirou. Faça login novamente.",
  "code": "TOKEN_EXPIRED"
}

{
  "error": "Token inválido",
  "message": "Token de autenticação inválido. Faça login novamente.",
  ...

{
  "error": "Token inválido",
  "message": "Token de autenticação inválido. Faça login novamente.",
  "code": "TOKEN_INVALID"
}

{
  "error": "Acesso revogado",
  "message": "Seu acesso foi desativado. Procure o administrador da clínica.",
  ...

{
  "error": "Acesso revogado",
  "message": "Seu acesso foi desativado. Procure o administrador da clínica.",
  "code": "ACCESS_REVOKED"
}