PUT/api/procedure-fields/{procedure_id}/fields/{field_id}

Editar campo

Muda só os campos enviados.

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

Headers

NomeTipoObrig.Descrição
Authorization
stringSimBearer {access_token}, com o token que o login devolve.
Content-Type
stringSimapplication/json

Parâmetros do caminho

NomeTipoObrig.Descrição
procedure_id
uuidSimO procedimento.
field_id
uuidSimO campo.

Corpo da requisição

NomeTipoObrig.Descrição
title
stringNãoO rótulo.
field_type
stringNãotext, number, textarea, select, date ou checkbox.
is_required
booleanNãoSe o agendamento tem de preenchê-lo.
options
string[] | stringNãoObrigatório para select: uma lista, ou um texto com as opções separadas por vírgula.
order_index
integerNãoA posição.

Campos da resposta

NomeTipoDescrição
id
uuidO campo.
procedure_id
uuidO procedimento a que pertence.
title
stringO rótulo do campo.
field_type
stringtext, number, textarea, select, date ou checkbox.
is_required
booleanSe o agendamento tem de preenchê-lo.
options
string[] | nullAs opções de um campo select; null nos outros tipos.
order_index
integerA posição, a partir de 1.
created_at
stringISO 8601.
updated_at
stringISO 8601.
deleted_at
string | nullSempre null nas respostas.

Request URL

https://api-endosystem.imagemais.com.br/api/procedure-fields/3c1e9a7b-2d4f-4b6a-8e0c-5f7a9b1c3d2e/fields/7a2b4c6d-8e0f-4a1b-9c3d-5e7f9a1b3c5d
curl -X PUT "https://api-endosystem.imagemais.com.br/api/procedure-fields/3c1e9a7b-2d4f-4b6a-8e0c-5f7a9b1c3d2e/fields/7a2b4c6d-8e0f-4a1b-9c3d-5e7f9a1b3c5d" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"is_required":false}'
{
  "is_required": false
}
{
  "is_required": false
}

Respostas

{
  "id": "7a2b4c6d-8e0f-4a1b-9c3d-5e7f9a1b3c5d",
  "procedure_id": "3c1e9a7b-2d4f-4b6a-8e0c-5f7a9b1c3d2e",
  ...
{
  "id": "7a2b4c6d-8e0f-4a1b-9c3d-5e7f9a1b3c5d",
  "procedure_id": "3c1e9a7b-2d4f-4b6a-8e0c-5f7a9b1c3d2e",
  "title": "Convênio",
  "field_type": "select",
  "is_required": false,
  "options": [
    "Particular",
    "Unimed",
    "Bradesco Saúde"
  ],
  "order_index": 1,
  "created_at": "2026-09-02T10:20:00-03:00",
  "updated_at": "2026-09-02T10:20:00-03:00",
  "deleted_at": null
}
{
  "error": "ID inválido"
}
{
  "error": "ID inválido"
}
{
  "error": "field_type deve ser um dos: text, number, textarea, select, date, checkbox"
}
{
  "error": "field_type deve ser um dos: text, number, textarea, select, date, checkbox"
}
{
  "error": "options é obrigatório para campos do tipo select"
}
{
  "error": "options é obrigatório para campos do tipo select"
}
{
  "error": "Procedimento não encontrado"
}
{
  "error": "Procedimento não encontrado"
}
{
  "error": "Campo não encontrado"
}
{
  "error": "Campo 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"
}
{
  "error": "Erro interno do servidor"
}
{
  "error": "Erro interno do servidor"
}