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

# Obtenir le dernier insight d'activité IA

> GET /user-logs/activity-insight/

Récupère l'insight d'activité hebdomadaire le plus récent du compte, sur l'hôte de l'**API de gestion** (`api.scanova.io`), authentifié avec votre clé d'API de gestion brute.

```
GET https://api.scanova.io/user-logs/activity-insight/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.scanova.io/user-logs/activity-insight/" \
    -H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": 55,
    "period_start": "2026-08-31",
    "period_end": "2026-09-06",
    "ai_response": {
      "summary": ["You created 6 QR codes this week, up from an average of 2."],
      "insights": ["A shared user (member@scanova.io) logged in for the first time this week."],
      "anomalies_explained": ["QR creation spiked mid-week, likely tied to a new campaign."],
      "recommendations": ["Consider tagging the new QR codes for easier filtering later."]
    },
    "total_tokens": 412,
    "generated_at": "2026-09-07T02:15:03Z"
  }
  ```
</ResponseExample>

<Note>
  Les insights sont générés hors bande selon une planification hebdomadaire, pas à la demande — cet endpoint renvoie toujours le plus récemment généré, en ignorant tout id. `404` si aucun insight n'a encore été généré pour le compte (par ex. un compte tout juste créé, ou avant la première exécution hebdomadaire).
</Note>

Lorsque rien de notable ne s'est produit cette semaine-là, `ai_response` se rabat sur un résumé basé sur un modèle (non généré par IA) plutôt que d'appeler le modèle sous-jacent — `total_tokens: 0` indique une réponse basée sur un modèle ; une valeur non nulle indique une réponse véritablement générée par IA.

## Voir aussi

* [Obtenir les statistiques d'activité quotidiennes](/fr/api-reference/management-api/user-logs/activity-summary) — les données brutes à partir desquelles cet insight est construit.
* [Présentation de l'API de gestion](/fr/api-reference/management-api/overview) — le schéma d'authentification et les règles de quota applicables à cet endpoint.


## OpenAPI

````yaml api-reference/openapi/management-api.json GET /user-logs/activity-insight/
openapi: 3.1.0
info:
  title: Scanova Management API (v2)
  description: >-
    The complete Scanova Management API — every endpoint available at
    api.scanova.io (QR codes, folders, tags, leads, forms, analytics, plans,
    shared users & roles), plus the token-creation and usage-stats endpoints
    used to authenticate against it. Every path and request/response shape below
    was verified live against a real API key and the actual running backend
    (Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
  version: 2.0.0
servers:
  - url: https://api.scanova.io
    description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
  - apiKeyAuth: []
paths:
  /user-logs/activity-insight/:
    get:
      summary: Get the latest AI activity insight
      description: >-
        The most recent weekly AI-generated (or templated, if nothing notable
        happened) summary of account activity. Generated out-of-band on a weekly
        schedule, not on request — `404` if none has been generated yet.
      operationId: getActivityInsight
      responses:
        '200':
          description: The latest insight.
          content:
            application/json:
              example:
                id: 55
                period_start: '2026-08-31'
                period_end: '2026-09-06'
                ai_response:
                  summary:
                    - You created 6 QR codes this week, up from an average of 2.
                  insights:
                    - >-
                      A shared user (member@scanova.io) logged in for the first
                      time this week.
                  anomalies_explained:
                    - >-
                      QR creation spiked mid-week, likely tied to a new
                      campaign.
                  recommendations:
                    - >-
                      Consider tagging the new QR codes for easier filtering
                      later.
                total_tokens: 412
                generated_at: '2026-09-07T02:15:03Z'
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Send your Management API key as the raw value of the Authorization
        header — no "Bearer " or "Token " prefix, and no other characters.
        Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
        header containing more than one space-separated part is rejected
        outright. Requests also require the request's Host header to be the
        management API host (e.g. api.scanova.io) — the same key sent to the
        regular API host will not authenticate.

````