> ## Documentation Index
> Fetch the complete documentation index at: https://docs.morada.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Frescor dos dados

> Frescor dos dados de analytics por metricset.

Consulta barata do frescor dos dados de analytics, por metricset (`conversations`, `tickets`).

Retorna, para cada metricset, o `as_of` (momento da última atualização bem-sucedida) e `stale` (`true` quando o dado está mais velho que \~2× a cadência de atualização, ou quando o frescor é desconhecido). Um carimbo ausente vira `{ as_of: null, stale: true }` — nunca é lido como atualizado.

<Tip>
  Use este endpoint antes de um pull de analytics para saber se vale a pena reprocessar — evita puxar dados que ainda não mudaram.
</Tip>


## OpenAPI

````yaml GET /v1/analytics/freshness
openapi: 3.1.0
info:
  title: Morada Data Export API
  version: 1.0.0
  description: >-
    Exportação incremental das conversas, mensagens, contatos e deals do seu
    workspace na Morada.ai, além de relatórios operacionais em nível de linha e
    analytics agregado (componentes aditivos) que reproduzem os dashboards da
    plataforma.
servers:
  - url: https://data-api.morada.ai
    description: Produção
security:
  - workspaceApiKey: []
tags:
  - name: Exportação
    description: Exportação incremental de entidades do workspace.
  - name: Relatórios
    description: >-
      Relatórios operacionais em nível de linha, com janela de tempo
      obrigatória.
  - name: Analytics
    description: >-
      Agregações aditivas prontas para BI, reproduzindo os dashboards da
      plataforma.
paths:
  /v1/analytics/freshness:
    get:
      tags:
        - Analytics
      summary: Frescor dos dados por metricset
      description: Frescor dos dados de analytics por metricset.
      responses:
        '200':
          description: Frescor por metricset.
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - count
                properties:
                  data:
                    type: array
                    description: Um item por metricset de analytics.
                    items:
                      type: object
                      required:
                        - metricset
                        - etl_job
                        - as_of
                        - stale
                      properties:
                        metricset:
                          type: string
                          description: Nome do metricset (`conversations`, `tickets`).
                        etl_job:
                          type: string
                          description: Nome do job de ETL que alimenta o metricset.
                        as_of:
                          type:
                            - string
                            - 'null'
                          description: >-
                            Momento (ISO 8601) da última execução de ETL
                            bem-sucedida; `null` quando desconhecido.
                        stale:
                          type: boolean
                          description: >-
                            `true` quando defasado (mais que ~2× a cadência de
                            6h) ou o frescor é desconhecido.
                  count:
                    type: integer
                    description: Número de metricsets retornados.
        '401':
          description: Chave de acesso ausente ou inválida.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Erro'
        '429':
          description: >-
            Limite de requisições excedido (cerca de 120 por minuto por
            workspace).
          headers:
            Retry-After:
              description: Segundos a aguardar antes de repetir a requisição.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Erro'
components:
  schemas:
    Erro:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Descrição do erro.
  securitySchemes:
    workspaceApiKey:
      type: http
      scheme: bearer
      description: >-
        Workspace API key no formato `mk_...`, gerada na plataforma em
        **Integrações → Configurar API**.

````