Processos (Cases)

Gerencie processos jurídicos do seu escritório. Processos são o core do Juspilot - representam ações judiciais, consultorias, contratos e qualquer trabalho jurídico.

GET /v1/cases

Lista todos os processos do time.

Query Parameters

Parâmetro	Tipo	Padrão	Descrição
`page`	number	1	Página atual
`limit`	number	20	Itens por página (máx: 100)
`status`	string	-	Filtrar por status: `ativo`, `arquivado`
`phase`	string	-	Filtrar por fase do kanban
`priority`	string	-	Filtrar por prioridade: `alta`, `media`, `baixa`
`area`	string	-	Filtrar por área do direito
`client_id`	string	-	Filtrar por cliente
`responsible_id`	string	-	Filtrar por responsável
`from`	string	-	Data de criação inicial (YYYY-MM-DD)
`to`	string	-	Data de criação final (YYYY-MM-DD)
`sort`	string	`-created_at`	Ordenação
`search`	string	-	Buscar por título ou número

Request

curl -X GET "https://api.juspilot.co/v1/cases?status=ativo&priority=alta" \
  -H "Authorization: Bearer jp_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": [
    {
      "id": "case_abc123def456",
      "title": "Ação de Cobrança - Contrato XYZ",
      "number": "0001234-56.2026.8.26.0100",
      "area": "Cível",
      "subject": "Cobrança",
      "phase": "em-andamento",
      "priority": "alta",
      "status": "ativo",
      "client": {
        "id": "cli_xyz789",
        "name": "João da Silva",
        "type": "PF"
      },
      "responsible": {
        "id": "user_123",
        "name": "Dr. Carlos Mendes"
      },
      "activities_count": 5,
      "documents_count": 12,
      "sla_date": "2026-03-15",
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-02-04T14:20:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 45,
    "pages": 3
  }
}

POST /v1/cases

Cria um novo processo.

Request Body

Campo	Tipo	Obrigatório	Descrição
`title`	string	Sim	Título do processo
`number`	string	Não	Número do processo (CNJ ou interno)
`area`	string	Não	Área do direito (Cível, Trabalhista, etc.)
`subject`	string	Não	Assunto/matéria do processo
`phase`	string	Não	Fase inicial no kanban (padrão: primeira fase)
`priority`	string	Não	Prioridade: `alta`, `media`, `baixa` (padrão: `media`)
`client_id`	string	Não	ID do cliente vinculado
`responsible_id`	string	Não	ID do usuário responsável
`sla_date`	string	Não	Data limite (YYYY-MM-DD)
`description`	string	Não	Descrição detalhada
`labels`	array	Não	Array de labels/tags
`metadata`	object	Não	Dados customizados

Request

curl -X POST https://api.juspilot.co/v1/cases \
  -H "Authorization: Bearer jp_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Ação de Cobrança - Contrato de Prestação de Serviços",
    "number": "0001234-56.2026.8.26.0100",
    "area": "Cível",
    "subject": "Cobrança",
    "phase": "recebido",
    "priority": "alta",
    "client_id": "cli_abc123def456",
    "sla_date": "2026-03-15",
    "description": "Cobrança de débito referente ao contrato de prestação de serviços firmado em janeiro de 2025.",
    "labels": ["urgente", "cliente-vip"]
  }'

Response

{
  "success": true,
  "data": {
    "id": "case_xyz789ghi012",
    "title": "Ação de Cobrança - Contrato de Prestação de Serviços",
    "number": "0001234-56.2026.8.26.0100",
    "area": "Cível",
    "subject": "Cobrança",
    "phase": "recebido",
    "priority": "alta",
    "status": "ativo",
    "client_id": "cli_abc123def456",
    "sla_date": "2026-03-15",
    "description": "Cobrança de débito referente ao contrato de prestação de serviços firmado em janeiro de 2025.",
    "labels": ["urgente", "cliente-vip"],
    "activities_count": 0,
    "documents_count": 0,
    "created_at": "2026-02-04T10:30:00Z",
    "updated_at": "2026-02-04T10:30:00Z"
  }
}

GET /v1/cases/:id

Busca um processo específico por ID.

Request

curl -X GET https://api.juspilot.co/v1/cases/case_xyz789ghi012 \
  -H "Authorization: Bearer jp_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": {
    "id": "case_xyz789ghi012",
    "title": "Ação de Cobrança - Contrato de Prestação de Serviços",
    "number": "0001234-56.2026.8.26.0100",
    "area": "Cível",
    "subject": "Cobrança",
    "phase": "recebido",
    "priority": "alta",
    "status": "ativo",
    "description": "Cobrança de débito referente ao contrato...",
    "client": {
      "id": "cli_abc123def456",
      "name": "João da Silva",
      "type": "PF",
      "email": "joao@email.com",
      "phone": "+55 11 99999-8888"
    },
    "responsible": {
      "id": "user_123",
      "name": "Dr. Carlos Mendes",
      "email": "carlos@escritorio.com"
    },
    "labels": ["urgente", "cliente-vip"],
    "activities_count": 5,
    "documents_count": 12,
    "sla_date": "2026-03-15",
    "metadata": {},
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-02-04T14:20:00Z"
  }
}

PUT /v1/cases/:id

Atualiza um processo existente.

Request Body

Todos os campos são opcionais. Envie apenas os campos que deseja atualizar.

Campo	Tipo	Descrição
`title`	string	Título do processo
`number`	string	Número do processo
`area`	string	Área do direito
`subject`	string	Assunto/matéria
`phase`	string	Fase no kanban
`priority`	string	Prioridade: `alta`, `media`, `baixa`
`status`	string	Status: `ativo`, `arquivado`
`client_id`	string	ID do cliente
`responsible_id`	string	ID do responsável
`sla_date`	string	Data limite (YYYY-MM-DD)
`description`	string	Descrição
`labels`	array	Labels/tags
`metadata`	object	Dados customizados

Request

curl -X PUT https://api.juspilot.co/v1/cases/case_xyz789ghi012 \
  -H "Authorization: Bearer jp_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "phase": "em-andamento",
    "priority": "media",
    "labels": ["urgente", "cliente-vip", "audiência-agendada"]
  }'

Response

{
  "success": true,
  "data": {
    "id": "case_xyz789ghi012",
    "title": "Ação de Cobrança - Contrato de Prestação de Serviços",
    "phase": "em-andamento",
    "priority": "media",
    "labels": ["urgente", "cliente-vip", "audiência-agendada"],
    "updated_at": "2026-02-04T15:00:00Z"
  }
}

DELETE /v1/cases/:id

Arquiva um processo (soft delete).

Esta operação não exclui permanentemente o processo. Ele pode ser restaurado alterando o status para ativo.

Request

curl -X DELETE https://api.juspilot.co/v1/cases/case_xyz789ghi012 \
  -H "Authorization: Bearer jp_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": {
    "id": "case_xyz789ghi012",
    "status": "arquivado",
    "archived_at": "2026-02-04T15:30:00Z"
  }
}

GET /v1/cases/:id/activities

Lista as atividades de um processo.

Request

curl -X GET https://api.juspilot.co/v1/cases/case_xyz789ghi012/activities \
  -H "Authorization: Bearer jp_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": [
    {
      "id": "act_123abc",
      "type": "task",
      "title": "Elaborar petição inicial",
      "status": "completed",
      "priority": "alta",
      "due_date": "2026-02-10",
      "completed_at": "2026-02-08T16:00:00Z",
      "created_at": "2026-02-01T10:00:00Z"
    },
    {
      "id": "act_456def",
      "type": "deadline",
      "title": "Prazo para contestação",
      "status": "pending",
      "priority": "alta",
      "due_date": "2026-02-20",
      "created_at": "2026-02-05T09:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 2,
    "pages": 1
  }
}

GET /v1/cases/:id/timeline

Retorna a timeline de eventos do processo.

Request

curl -X GET https://api.juspilot.co/v1/cases/case_xyz789ghi012/timeline \
  -H "Authorization: Bearer jp_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": [
    {
      "id": "evt_001",
      "type": "phase_change",
      "description": "Processo movido para 'em-andamento'",
      "user": {
        "id": "user_123",
        "name": "Dr. Carlos Mendes"
      },
      "created_at": "2026-02-04T15:00:00Z"
    },
    {
      "id": "evt_002",
      "type": "document_added",
      "description": "Documento 'Petição Inicial.pdf' adicionado",
      "user": {
        "id": "user_456",
        "name": "Ana Silva"
      },
      "created_at": "2026-02-03T11:30:00Z"
    },
    {
      "id": "evt_003",
      "type": "case_created",
      "description": "Processo criado",
      "user": {
        "id": "user_123",
        "name": "Dr. Carlos Mendes"
      },
      "created_at": "2026-01-15T10:30:00Z"
    }
  ]
}

Fases do Kanban

As fases são configuráveis por time. Fases padrão:

Fase	Descrição
`recebido`	Processo recém-recebido
`triagem`	Em análise inicial
`em-andamento`	Trabalho ativo
`em-revisão`	Aguardando revisão
`finalizado`	Concluído

Áreas do Direito

Valores sugeridos (customizáveis):

Cível
Trabalhista
Tributário
Empresarial
Criminal
Família
Consumidor
Administrativo
Ambiental
Imobiliário

Erros Comuns

Código	Erro	Solução
`400`	`Invalid phase`	Use uma fase válida do time
`400`	`Invalid priority`	Use: `alta`, `media` ou `baixa`
`404`	`Case not found`	Verifique o ID do processo
`404`	`Client not found`	Verifique o client_id
`422`	`Duplicate case number`	Número do processo já existe

Processos (Cases)

On this page