Revisar / arquivar um vídeo

Cria ou atualiza a revisão de um vídeo. Para arquivar, envie "status": "ARCHIVED". Vídeos arquivados deixam de aparecer na lista de mídias, nos eventos de risco e nos relatórios.

A requisição substitui a revisão inteira. Para arquivar sem perder as correções do revisor:

  1. Busque a revisão atual em GET /public/v1/camera/media (campo safety_review do vídeo).
  2. Reenvie driver_id, severity e dismiss_reason como estão e coloque os id
    de occurrences em occurrences_ids.
  3. Troque apenas status para "ARCHIVED".

Para desarquivar, prefira POST /cameras/safety-review/{mediaId}/unarchive, que mantém as correções. Enviar "RELEVANT" ou null aqui também desarquiva, mas substitui a revisão inteira.

Regras:

  • Só é possível arquivar vídeos de evento ("EVENT_VIDEO") de frotas com a configuração
    "Arquivar vídeos revisados" ligada no painel Cobli. Nos outros casos a requisição retorna 409:
    trate como "arquivamento indisponível para este vídeo ou frota".

  • Com a configuração ligada, descartar ("DISMISSED") um vídeo de evento também o arquiva:
    a resposta traz "status": "ARCHIVED" e mantém o dismiss_reason enviado. Com a
    configuração desligada, o vídeo fica "DISMISSED".

  • Arquivar um vídeo que já está arquivado mantém o vídeo arquivado.

  • O arquivamento registra a origem API e a chave usada em archived_origin,
    archived_api_key_name e archived_api_key_prefix.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
uuid
required

UUID Identificação do vídeo

string | null
enum

Status da revisão. null deixa o vídeo como não revisado

Allowed:
uuid | null

Identificação do motorista

occurrences_ids
array of uuids | null

Identificação das ocorrências

occurrences_ids
string | null
enum

Severidade do evento

Allowed:
string | null
enum

Motivo do descarte

Allowed:
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

400

Corpo inválido (por exemplo, sem media_id ou com valor fora da lista). Resposta sem corpo.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/plain