Developers

Aparência

Vai integrar a API REST da Zarv com ajuda de IA? Copie a instrução que aponta o modelo para esta documentação.
Ver a instrução
Você vai integrar a API REST da Zarv. Use a documentação oficial como fonte da verdade.

- Página desta integração: https://developers.zarv.com/api/lens/updateResearch
- Autenticação Bearer JWT e hosts: https://developers.zarv.com/setup
- Índice das APIs: https://developers.zarv.com/api
- Índice da documentação em markdown: https://developers.zarv.com/llms.txt
- Documentação completa em um arquivo: https://developers.zarv.com/llms-full.txt

Os specs OpenAPI publicados são a fonte da verdade para rotas e schemas — use o spec da API que você escolher antes de escrever qualquer request.

Antes de escrever qualquer código, leia a página desta integração. Siga exatamente os nomes de campos, endpoints, callbacks e formatos que estiverem documentados — não invente parâmetros nem endpoints, e não deduza comportamento a partir de outras APIs que você conhece. Se algo de que você precisa não estiver na documentação, diga que não está em vez de supor.

Minha tarefa: [ex.: escolher a API certa e fazer a primeira chamada autenticada]

Editar o caso e movê-lo no quadro​

PUT
/api/v1/lens/{workspaceId}/research/{id}

Um PATCH do caso: o campo ausente (ou null) não muda, e string vazia não apaga. status, userId, domain e workspaceId não são campos editáveis — vindos no corpo, são ignorados.

kanbanId move o caso para outra raia do quadro. A raia precisa ser uma linha ACTIVE do quadro deste workspace; qualquer outra coisa é 400. Com o envio dos documentos ou a análise rodando, o movimento é 409: naquele momento, o caso é do worker.

É por aqui que o analista dá o desfecho: mover para Aprovado ou Reprovado (fase DESFECHO), ou devolver o caso para Dados pendentes quando falta material.

Authorizations​

BearerAuth

Token Bearer JWT obtido em POST /api/v1/authentication. O workspace do token precisa ser o mesmo do caminho.

Type
HTTP (bearer)

Parameters​

Path Parameters

workspaceId*

O workspace dono do caso. Tem de ser o workspace do token.

Type
string
Required
Example"3f1a2b4c-5d6e-4f70-8a91-b2c3d4e5f607"
Format
"uuid"
id*

O id do caso.

Type
string
Required
Example"7d2f8e10-4c3b-4a5d-9e8f-1a2b3c4d5e6f"
Format
"uuid"

Request Body​

application/json
JSON
{
  
"objective": "sinistro",
  
"incidentType": "colisao",
  
"reportAddress": "string",
  
"reportTime": "string",
  
"reportText": "string",
  
"doubts": [
  
  
"string"
  
],
  
"kanbanId": "9d4a1c83-7e26-5f40-ab58-2c6d9e0f4a71"
}

Responses​

O caso depois da edição, já na raia nova.

application/json
JSON
{
  
"id": "string",
  
"workspaceId": "string",
  
"userId": "string",
  
"domain": "auto",
  
"objective": "sinistro",
  
"reportAddress": "string",
  
"reportText": "string",
  
"doubts": [
  
  
"string"
  
],
  
"status": "CREATED",
  
"incidentType": "colisao",
  
"bot": {
  
  
"additionalProperties": "string"
  
},
  
"kanbanId": "string",
  
"createdAt": "string",
  
"updatedAt": "string",
  
"reportTime": "string"
}

Playground​

Authorization
Variables
Key
Value
Body

Samples​

Powered by VitePress OpenAPI