Endpoint

Alterar processo ou caso

PATCH/api/v1/{escritorio}/processos/{id}

Altera um ou mais campos. É tudo ou nada: com um campo inválido, 400 com campos e nada é gravado. Trocar a natureza de Judicial para outra, com número, tribunal, Justiça ou pagamento preenchidos, pede confirmado: true; sem ele, 400 CONFIRMACAO_NECESSARIA. Processo de uma árvore de relacionados não vira caso consultivo: 400 CASO_SEM_RELACIONADOS. Número CNJ que já está em outro processo do escritório: 409 NUMERO_EM_USO (com processo quando a pessoa dona do token pode vê-lo), e nada é gravado; litisconsórcio se faz com adicionar_cliente_ao_processo no processo existente.

Permissão exigida

Operacional: Alterar

Só leitura recusa com 403

Parâmetros de caminho

escritoriotextoobrigatório
Código do escritório, com 5 dígitos. Os escritórios em que o token vale estão em GET /api/v1/eu.
idtextoobrigatório
Identificador do processo.

Corpo

departamentoIdtexto ou nulo
Departamento
naturezatexto ou nulo
Natureza
statusIdtexto ou nulo
Status
descricaotexto ou nulo
Descrição
assuntotexto ou nulo
Assunto
numeroCnjtexto ou nulo
Número CNJ
tribunalSiglatexto ou nulo
Tribunal
grautexto ou nulo
Grau
enteDevedortexto ou nulo
Ente devedor
comarcatexto ou nulo
Comarca
varatexto ou nulo
Vara
magistradotexto ou nulo
Magistrado
classetexto ou nulo
Classe
autortexto ou nulo
Autor
autorDoctexto ou nulo
CPF/CNPJ do autor
reutexto ou nulo
Réu
reuDoctexto ou nulo
CPF/CNPJ do réu
dtDistribuicaotexto ou nulo
Distribuição (AAAA-MM-DD).
dtSentencatexto ou nulo
Data da sentença (AAAA-MM-DD).
resultadoSentencatexto ou nulo
Resultado da sentença
dtTransitotexto ou nulo
Trânsito em julgado (AAAA-MM-DD).
dtArquivamentotexto ou nulo
Arquivamento (AAAA-MM-DD).
numeroAdmtexto ou nulo
Nº do processo administrativo
orgaotexto ou nulo
Órgão
dtDertexto ou nulo
Data DER (AAAA-MM-DD).
tipoBeneficiotexto ou nulo
Tipo Benefício
statusGeridtexto ou nulo
Status GERID/INSS
confirmadoverdadeiro ou falso
Obrigatório ao trocar a natureza de Judicial quando há número, tribunal, Justiça ou pagamento: serão apagados.

Testar

Exemplo

cURL

curl -X PATCH "https://developer.jur.ia2s.com.br/api/v1/10345/processos/SEU_ID" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "descricao": "Revisão do benefício e pagamento das diferenças"
}'

Node

// Node 18 ou mais novo, em um arquivo .mjs
const resposta = await fetch("https://developer.jur.ia2s.com.br/api/v1/10345/processos/SEU_ID", {
  method: "PATCH",
  headers: {
    Authorization: "Bearer SEU_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "descricao": "Revisão do benefício e pagamento das diferenças"
  }),
});
console.log(resposta.status, await resposta.json());

Python

import requests

resposta = requests.patch(
    "https://developer.jur.ia2s.com.br/api/v1/10345/processos/SEU_ID",
    headers={"Authorization": "Bearer SEU_TOKEN"},
    json={
        "descricao": "Revisão do benefício e pagamento das diferenças",
    },
)
print(resposta.status_code)
print(resposta.json())

Respostas

200

Sucesso.

{
  "id": "0190a000-0000-7000-8000-000000000001",
  "clienteCodigo": "EX-0001",
  "clientes": [
    {
      "codigo": "EX-0001",
      "nome": "Maria Oliveira",
      "principal": true
    }
  ],
  "departamentoId": "0190a000-0000-7000-8000-000000000002",
  "natureza": "JUDICIAL",
  "origemId": null,
  "raizId": null,
  "tipoRelacao": null,
  "statusId": "0190a000-0000-7000-8000-000000000003",
  "descricao": "Horas extras",
  "assunto": null,
  "numeroCnj": "00012342720265020001",
  "tribunalSigla": "TRT2",
  "grau": "PRIMEIRO_GRAU",
  "justica": "TRABALHO",
  "enteDevedor": null,
  "comarca": "São Paulo",
  "vara": null,
  "magistrado": null,
  "classe": null,
  "autor": "Maria Oliveira",
  "autorDoc": null,
  "reu": "Empresa Exemplo Ltda.",
  "reuDoc": null,
  "partes": [],
  "dtDistribuicao": "2026-02-10",
  "dtSentenca": null,
  "resultadoSentenca": null,
  "dtTransito": null,
  "dtArquivamento": null,
  "numeroAdm": null,
  "orgao": null,
  "dtDer": null,
  "tipoBeneficio": null,
  "statusGerid": null,
  "etiquetas": [],
  "contagens": {
    "andamentos": 3,
    "prazosAbertos": 1,
    "trabalhosAbertos": 0
  },
  "criadoEm": "2026-11-06T12:00:00.000Z"
}

Campos da resposta

idtextoobrigatório
clienteCodigotextoobrigatório
Código do cliente principal.
clienteslista de objetosobrigatório
O cliente principal e os litisconsortes.
- codigotextoobrigatório
- nometextoobrigatório
- principalverdadeiro ou falsoobrigatório
departamentoIdtextoobrigatório
naturezatextoobrigatório
Valores: JUDICIALADMINISTRATIVOCONSULTIVO
origemIdtexto ou nuloobrigatório
Processo de origem, quando este é um processo relacionado.
raizIdtexto ou nuloobrigatório
Processo raiz da árvore; nulo na própria raiz e em processo sem relacionados.
tipoRelacaotexto ou nuloobrigatório
Tipo de relação com o processo de origem; nulo na raiz e em processo sem relacionados.
Valores: CUMPRIMENTO_SENTENCARECURSOAGRAVO_INSTRUMENTORPVPRECATORIOALVARAOUTRO
statusIdtextoobrigatório
descricaotexto ou nuloobrigatório
assuntotexto ou nuloobrigatório
Pedido no caso consultivo.
numeroCnjtexto ou nuloobrigatório
Só os 20 dígitos.
tribunalSiglatexto ou nuloobrigatório
grautexto ou nuloobrigatório
Valores: PRIMEIRO_GRAUSEGUNDO_GRAU
justicatexto ou nuloobrigatório
Valores: SUPERIORFEDERALTRABALHOELEITORALMILITAR_UNIAOESTADUALMILITAR_ESTADUAL
enteDevedortexto ou nuloobrigatório
Valores: FEDERALESTADUALMUNICIPALPARTICULAR
comarcatexto ou nuloobrigatório
varatexto ou nuloobrigatório
magistradotexto ou nuloobrigatório
classetexto ou nuloobrigatório
autortexto ou nuloobrigatório
autorDoctexto ou nuloobrigatório
reutexto ou nuloobrigatório
reuDoctexto ou nuloobrigatório
parteslista de objetosobrigatório
- idtextoobrigatório
- polotextoobrigatório
  Valores: ATIVOPASSIVO
- nometextoobrigatório
- documentotexto ou nuloobrigatório
- ordemnúmero inteiroobrigatório
dtDistribuicaotexto ou nuloobrigatório
AAAA-MM-DD.
dtSentencatexto ou nuloobrigatório
AAAA-MM-DD.
resultadoSentencatexto ou nuloobrigatório
Valores: PROCEDENTEPARCIALMENTE_PROCEDENTEIMPROCEDENTE
dtTransitotexto ou nuloobrigatório
AAAA-MM-DD.
dtArquivamentotexto ou nuloobrigatório
AAAA-MM-DD.
numeroAdmtexto ou nuloobrigatório
orgaotexto ou nuloobrigatório
dtDertexto ou nuloobrigatório
AAAA-MM-DD.
tipoBeneficiotexto ou nuloobrigatório
statusGeridtexto ou nuloobrigatório
etiquetaslista de textosobrigatório
Identificadores das etiquetas.
contagensobjetoobrigatório
- andamentosnúmero inteiroobrigatório
- prazosAbertosnúmero inteiroobrigatório
- trabalhosAbertosnúmero inteiroobrigatório
  Só os do caso, no consultivo.
criadoEmtextoobrigatório

400

Corpo ou parâmetro inválido.

INVALIDO

{
  "codigo": "INVALIDO",
  "mensagem": "Confira os dados informados.",
  "campos": {
    "departamentoId": "Valor inválido."
  }
}

CHAVE_IDEMPOTENCIA_INVALIDA

{
  "codigo": "CHAVE_IDEMPOTENCIA_INVALIDA",
  "mensagem": "A Idempotency-Key deve ter de 1 a 255 caracteres visíveis, sem espaços."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

401

Sem token, ou token revogado ou expirado, ou pessoa desativada.

TOKEN_INVALIDO

{
  "codigo": "TOKEN_INVALIDO",
  "mensagem": "Token de API inválido, expirado ou revogado."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

403

A pessoa não pode fazer isto, o token é só de leitura, foi bloqueado neste escritório, não tem esta operação, quem o gerou saiu do escritório ou o acesso ao escritório está suspenso.

SEM_PERMISSAO

{
  "codigo": "SEM_PERMISSAO",
  "mensagem": "Sem permissão para esta alteração."
}

TOKEN_SO_LEITURA

{
  "codigo": "TOKEN_SO_LEITURA",
  "mensagem": "Este token é só de leitura."
}

TOKEN_SEM_ESCOPO

{
  "codigo": "TOKEN_SEM_ESCOPO",
  "mensagem": "Este token não tem permissão para esta operação."
}

TOKEN_BLOQUEADO

{
  "codigo": "TOKEN_BLOQUEADO",
  "mensagem": "Este token foi bloqueado pela administração deste escritório."
}

TOKEN_AUTOR_INATIVO

{
  "codigo": "TOKEN_AUTOR_INATIVO",
  "mensagem": "Quem gerou este token não está mais ativo neste escritório."
}

ESCRITORIO_SUSPENSO

{
  "codigo": "ESCRITORIO_SUSPENSO",
  "mensagem": "O acesso a este escritório está suspenso. Fale com a IA2S."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

404

Não existe, está fora do alcance da pessoa, ou o escritório do caminho não é dela.

NAO_ENCONTRADO

{
  "codigo": "NAO_ENCONTRADO",
  "mensagem": "Não encontrado."
}

ESCRITORIO_NAO_ENCONTRADO

{
  "codigo": "ESCRITORIO_NAO_ENCONTRADO",
  "mensagem": "Escritório não encontrado."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

409

Conflito: veja o campo `codigo`.

TENTE_NOVAMENTE

{
  "codigo": "TENTE_NOVAMENTE",
  "mensagem": "Outra pessoa alterou isto ao mesmo tempo. Tente novamente."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

413

Corpo da requisição grande demais.

CORPO_GRANDE

{
  "codigo": "CORPO_GRANDE",
  "mensagem": "O corpo da requisição é grande demais."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

429

Limite de 120 requisições por minuto.

Cabeçalho Retry-After: Segundos até poder tentar de novo.

LIMITE_TOKEN

{
  "codigo": "LIMITE_TOKEN",
  "mensagem": "Muitas requisições com este token. Tente de novo em um minuto."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

503

O sistema está ocupado. Tente em instantes.

SISTEMA_OCUPADO

{
  "codigo": "SISTEMA_OCUPADO",
  "mensagem": "O sistema está ocupado. Tente em instantes."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório