Endpoint

Alterar trabalho

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

Altera um ou mais campos, tudo ou nada: com um campo inválido, 400 com campos e nada é gravado. Sem Trabalhos: Aprovar mudança de data, mudar o vencimento cria uma solicitação (a data atual continua valendo): o corpo, com os outros campos já gravados, responde 202 { pendente: true, solicitacaoId }. Com a permissão, ou sem mudar a data, responde 200 com o trabalho.

Permissão exigida

Trabalhos: Alterar e Ficha do cliente: Acessar, com Atendimento: Acessar ou processo do cliente no alcance; datas sem Trabalhos: Aprovar mudança de data viram solicitação

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 trabalho.

Corpo

nometexto
Nome da tarefa.
prioridadetexto
Normal, alta ou urgente.
Valores: NORMALALTAURGENTE
responsaveislista de textos
Identificadores dos responsáveis (listar_membros); ao menos um.
vencimentotexto
AAAA-MM-DD. Sem Trabalhos: Aprovar mudança de data, vira solicitação e a data atual continua valendo.
concluidoverdadeiro ou falso
Marca ou desmarca como concluído.

Testar

Exemplo

cURL

curl -X PATCH "https://developer.jur.ia2s.com.br/api/v1/10345/trabalhos/SEU_ID" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "vencimento": "2026-12-20"
}'

Node

// Node 18 ou mais novo, em um arquivo .mjs
const resposta = await fetch("https://developer.jur.ia2s.com.br/api/v1/10345/trabalhos/SEU_ID", {
  method: "PATCH",
  headers: {
    Authorization: "Bearer SEU_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "vencimento": "2026-12-20"
  }),
});
console.log(resposta.status, await resposta.json());

Python

import requests

resposta = requests.patch(
    "https://developer.jur.ia2s.com.br/api/v1/10345/trabalhos/SEU_ID",
    headers={"Authorization": "Bearer SEU_TOKEN"},
    json={
        "vencimento": "2026-12-20",
    },
)
print(resposta.status_code)
print(resposta.json())

Respostas

200

Sucesso.

{
  "id": "0190a000-0000-7000-8000-000000000001",
  "nome": "Redigir parecer",
  "prioridade": "NORMAL",
  "vencimento": "2026-12-01",
  "concluido": false,
  "responsaveis": [
    "0190a000-0000-7000-8000-000000000002"
  ],
  "pendente": null,
  "caso": null
}

Campos da resposta

idtextoobrigatório
nometextoobrigatório
prioridadetextoobrigatório
Normal, alta ou urgente.
Valores: NORMALALTAURGENTE
vencimentotextoobrigatório
AAAA-MM-DD.
concluidoverdadeiro ou falsoobrigatório
responsaveislista de textosobrigatório
Identificadores dos responsáveis.
pendenteobjeto ou nuloobrigatório
Pedido de novo vencimento aguardando aprovação; o vencimento acima continua valendo.
- idtextoobrigatório
  Identificador da solicitação.
- campotextoobrigatório
  Qual data foi pedida.
  Valores: VENCIMENTOFATAL
- dataNovatextoobrigatório
  AAAA-MM-DD; só vale depois da aprovação.
- solicitanteIdtextoobrigatório
- criadoEmtextoobrigatório
casoobjeto ou nuloobrigatório
O caso consultivo a que o trabalho se liga.
- processoIdtextoobrigatório
- titulotextoobrigatório

202

Sucesso.

{
  "pendente": true,
  "solicitacaoId": "0190a000-0000-7000-8000-000000000003"
}

Campos da resposta

pendentetrueobrigatório
solicitacaoIdtextoobrigatório
A solicitação de nova data, aguardando aprovação; a data atual continua valendo.

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