Retomar
Retoma uma negociação pausada, reativando a atuação do agente.
POST
https://external-api.arbitralis.com.br/api/external/v1/extrajudicial/negotiations/{id}/resumeAutenticação
X-API-KEYSíncrono — a resposta já traz o resultadoRetoma uma negociação pausada (PAUSED → ACTIVE), reativando o agente. Se houver pendências bloqueantes no caso, a negociação permanece em atendimento humano até que sejam resolvidas.
Parâmetros de rota
iduuidobrigatórioIdentificador do caso de negociação.
Não há corpo de requisição.
Quando não é possível retomar
| Status atual | Retomar |
|---|---|
PAUSED | Sim |
ACTIVE, STARTED | Já está ativa |
AGREEMENT_CLOSED, NO_AGREEMENT, CLOSED | Não — use Reabrir quando o tipo de encerramento permitir |
| Arquivada | Não |
Retomar × reabrir
Retomar vale para negociação pausada — ela nunca foi encerrada. Reabrir vale para negociação já encerrada e exige justificativa. São operações distintas.
Pendências bloqueantes
Se o caso tem pendências que exigem decisão humana, a retomada mantém a negociação em modo de atendimento humano — o agente só volta a atuar depois que elas forem resolvidas no painel.
Erros
| Código | Causa |
|---|---|
400 | Status atual não permite retomada |
401 | API key ausente, inválida ou inativa |
404 | Negociação não encontrada neste workspace |
429 | Limite de requisições excedido |
Requisição
curl -X POST "https://external-api.arbitralis.com.br/api/external/v1/extrajudicial/negotiations/1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d/resume" \
-H "X-API-KEY: arb_live_SUA_CHAVE"const negociacaoId = '1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d';
const response = await fetch(
`https://external-api.arbitralis.com.br/api/external/v1/extrajudicial/negotiations/${negociacaoId}/resume`,
{
method: 'POST',
headers: { 'X-API-KEY': 'arb_live_SUA_CHAVE' },
}
);
const { data } = await response.json();import requests
negociacao_id = "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
response = requests.post(
f"https://external-api.arbitralis.com.br/api/external/v1/extrajudicial/negotiations/{negociacao_id}/resume",
headers={"X-API-KEY": "arb_live_SUA_CHAVE"},
)
data = response.json()["data"]Resposta
{
"success": true,
"data": {
"negociacaoId": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"status": "ACTIVE"
}
}{
"success": false,
"error": {
"code": "BAD_REQUEST",
"message": "Negociação não pode ser retomada no status atual.",
"errorEventId": "b1f3c6d8-2a44-4d9e-9f10-7c5b8e2a1d33"
}
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Negociação não encontrada.",
"errorEventId": "c2e4d7f9-3b55-4ea0-8021-6d4c9f3b2e44"
}
}