Skip to content

Atualiza um assunto com validação

Request

Atualiza um assunto existente com validação. O body aceita config, form, step e/ou form_tramites — qualquer outro campo é ignorado pela allowlist do service, e um body sem nenhum campo permitido retorna 400.

Semântica de escrita por campo:

  • config e step usam dot-notation: enviar { step: { config: [...] } } substitui apenas step.config e mantém step.shared intacto. Para trocar o objeto inteiro, envie todas as subchaves explicitamente.
  • form é REPLACE completo do array.
  • form_tramites (área interna / aba de trâmite) também é REPLACE completo do array e, no assunto, mora em config.form_tramites. Pode ser enviado no topo do body ({ form_tramites: [...] }, normalizado para config.form_tramites) ou aninhado em config — nunca nos dois no mesmo request (400 conflicting_fields). Precisa ser array (400 invalid_field_type). Na resposta ele volta dentro de config.

⚠️ form_tramites é snapshotado dentro de cada processo na protocolização. Editar o assunto só afeta processos novos; processos já protocolados exigem migração na collection process.

O campo opcional from identifica o caller no histórico do assunto (historico_types), ex.: "davi-bot:ticket-259147". Sem from, o histórico é registrado como "hub-api".

O limite de corpo desta rota é de 10 MB (forms Formly grandes estouravam o default de 1 MiB do Fastify).

Security
InternalAuth
Path
typeIdstringrequired

ID MongoDB do assunto

Example:69aae29b8f070e4432a63036
Bodyapplication/jsonrequired
configobject

Configurações do assunto a serem atualizadas

formArray of objects

Definição dos campos do formulário a ser atualizada (REPLACE completo)

stepobject

Configuração de etapas do assunto. Atualizada por dot-notation — as subchaves não enviadas são preservadas

form_tramitesArray of objects

Formulário da área interna / aba de trâmite (REPLACE completo). Normalizado para config.form_tramites. Não envie junto com config.form_tramites no mesmo request

fromstring

Identificador opcional do caller, salvo como user no historico_types. Default: hub-api

Example:"davi-bot:ticket-259147"
PATCH
/hub-api/type/edit/{typeId}
curl -i -X PATCH \
  https://api.producao.aprova.com.br/hub-api/type/edit/69aae29b8f070e4432a63036 \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -d '{
    "from": "davi-bot:ticket-259147",
    "config": {
      "devolverAoUltimo": true,
      "title": "Titulo novo assunto",
      "descricao": "Descrição",
      "cidade": "saopaulosp",
      "approveActionText": "Deferir",
      "markdown": "Acesse a aba Resumo para verificar o andamento do seu processo",
      "sigla": "NEW",
      "templates": [],
      "form_tramites": [],
      "fluxograma": {
        "fields": []
      }
    }
  }'

Responses

Assunto atualizado com sucesso

Bodyapplication/json
_idstring
Example:"69aae29b8f070e4432a63036"
configobject
formArray of objects
stepobject

Configuração de etapas do assunto, quando existir

Response
{
  "_id": "69aae29b8f070e4432a63036",
  "config": {
    "devolverAoUltimo": true,
    "title": "Titulo novo assunto",
    "descricao": "Descrição",
    "cidade": "saopaulosp",
    "approveActionText": "Deferir",
    "sigla": "NEW",
    "tenance": "Geral"
  },
  "form": [
    { … }
  ]
}