Editar processo (substituição total)
PUT · API de Integração v2
/v2/processos/{id}Editar processo
Substitui o processo inteiro (PUT idempotente). O id vem do path; o corpo é o mesmo do cadastro e representa o estado final completo.
Coleções: marcadorIds, partes, responsavelIds e equipeIds são substituídas pelo que vier — o que não estiver no corpo é removido. Para manter algo, reenvie-o.
Identidade/escopo: o escritório vem da chave de API; só é possível editar processo do próprio escritório (senão 404).
Trocar número ou tribunal
A identidade do processo é número + tribunal. Se o novo par já pertencer a outro processo do escritório, a edição é recusada com 409 — inclusive quando esse outro processo está excluído, e nesse caso a mensagem diz isso, porque ele não aparece nas listagens. Não há fusão automática: restaure o outro processo e decida o que fazer com ele.
A comparação ignora a máscara: 0000001-02.2020.8.26.0100 e 00000010220208260100 são o mesmo número. Reenviar o número atual do próprio processo nunca é conflito.
Autenticação
X-API-Key no cabeçalho. Como autenticar
Parâmetros de caminho1
idintegerobrigatórioID do processo a editar.
Corpo da requisiçãoobrigatório
Estado final do processo (mesmo corpo do cadastro).
application/json
camposPersonalizadosCampoPersonalizado[]Ver propriedades
campoIdintegerobrigatóriovaloresstring[]controleAcessoControleAcessoVer propriedades
equipeIdsinteger[]responsavelIdsinteger[]dadosBasicosDadosBasicosobrigatórioVer propriedades
areaIdintegerassuntoIdsinteger[]classeJudicialstringemGrauRecursobooleanformatoNumerostringmarcadorIdsinteger[]monitoramentoAtivobooleannumeroInternostringnumeroProcessostringobrigatóriopastastringprotocolostringsegredoJusticabooleansituacaostringstatusProcessostringobrigatóriotipoProcessointegertribunalIdintegerobrigatóriovalorCausanumbervalorCondenacaonumberdetalhesComplementaresDetalhesComplementaresVer propriedades
dataArquivamentostringdataAutuacaostringdataDistribuicaostringdataFechamentostringdataRequerimentostringdataTransitoJulgadostringdescricaoHonorariosstringexitoIdstringfaseIdintegernaturezaAcaoIdstringobservacoesstringorgaoVarastringresultadoIdstringriscoIdstringtipoAcaoIdstringpartesPartesobrigatórioVer propriedades
clientesPoloVer propriedades
advogadoIdsinteger[]clienteIdsinteger[]testemunhaIdsinteger[]tipoPolostringpartesContrariasPoloVer propriedades
advogadoIdsinteger[]clienteIdsinteger[]testemunhaIdsinteger[]tipoPolostringRespostas6
Exemplos ilustrativos · nenhuma requisição é enviada
200 · Sucesso
- Quando acontece
- A operação foi concluída.
- Como tratar
- Leia os dados retornados; em listagens, confira também a paginação.
Exemplo declarado no OpenAPI · application/json
{
"id": 45210,
"numeroProcesso": "0001234-96.2026.8.17.0001",
"reativado": false
}Contrato de respostas
200Processo atualizado.
Processo atualizado.
application/json
idintegernumeroProcessostringreativadoboolean400Payload inválido (erro de validação).
Payload inválido (erro de validação).
O contrato não declara um corpo para esta resposta.
401Não autenticado (token ausente/inválido).
Não autenticado (token ausente/inválido).
O contrato não declara um corpo para esta resposta.
403Usuário sem permissão de editar processo.
Usuário sem permissão de editar processo.
O contrato não declara um corpo para esta resposta.
404Processo não encontrado no escritório autenticado.
Processo não encontrado no escritório autenticado.
O contrato não declara um corpo para esta resposta.
409O novo número/tribunal já pertence a outro processo do escritório (inclusive excluído); ou o limite de processos monitorados do pl
O novo número/tribunal já pertence a outro processo do escritório (inclusive excluído); ou o limite de processos monitorados do plano foi atingido ao ligar o monitoramento. Distinga pelo campo code.
O contrato não declara um corpo para esta resposta.