Alterações retroativas

GET

/v1/t/{tenantID}/audit/revisions

curl --request GET \
  --url 'https://dash.owiew.com/v1/t/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/audit/revisions?limit=100' \
  --header 'Authorization: Bearer <token>'

• Produção

Números que a plataforma mudou DEPOIS de já os ter reportado.

É a rota que responde ‘esse número estava diferente ontem’. Se você guarda histórico do nosso dado, reconcilie por aqui — sem isso, o seu banco vai divergir do nosso sem que nada acuse.

Exige a permissão audit.read.

Authorizations

• tokenDeAcesso

Parameters

Path Parameters

tenantID

required

string format: uuid

O cliente. Vem SEMPRE do caminho — nunca de cabeçalho, nunca de cookie. Ele é conferido contra o token: um identificador que não bata com o do token devolve 403, e não uma resposta vazia.

Query Parameters

limit

integer

default: 100 >= 1 <= 1000

Quantas alterações devolver, das mais recentes. Esta rota NÃO lê since/until.

Responses

200

OK

Media typeapplication/json

object

revisions

Array<object>

Uma alteração retroativa: a plataforma mudou um número já reportado.

object

date

string format: date

campaign_id

string

campaign_name

string

field

O campo que mudou.

string

previous

string

nullable

current

string

nullable

delta

integer format: int64

nullable

observed_at

string format: date-time

lag_days

Dias entre o fato e a observação da mudança.

integer

restatement

Verdadeiro para reapuração retroativa; falso para acúmulo do dia corrente.

boolean

reason

A causa provável da alteração.

string

Example ^generated

{
  "revisions": [
    {
      "date": "2026-04-15",
      "campaign_id": "example",
      "campaign_name": "example",
      "field": "example",
      "previous": "example",
      "current": "example",
      "delta": 1,
      "observed_at": "2026-04-15T12:00:00Z",
      "lag_days": 1,
      "restatement": true,
      "reason": "example"
    }
  ]
}

401

Token ausente, malformado ou vencido.

Media typeapplication/json

object

error

object

code

Código estável, seguro para comparar.

string

message

Texto para pessoa. Pode mudar entre versões — não decida nada a partir dele.

string

trace_id

Identificador da ocorrência. Cite-o ao pedir suporte.

string

Example ^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "trace_id": "example"
  }
}

403

O token é válido, e o escopo não. Ou ele foi emitido para outro cliente, ou o papel não inclui a permissão da rota. NÃO é 404 de propósito: esconder um erro de escopo atrás de ‘não encontrado’ faz quem integra procurar o problema no lugar errado.

Media typeapplication/json

object

error

object

code

Código estável, seguro para comparar.

string

message

Texto para pessoa. Pode mudar entre versões — não decida nada a partir dele.

string

trace_id

Identificador da ocorrência. Cite-o ao pedir suporte.

string

Example ^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "trace_id": "example"
  }
}