**Versions de l’API** · **V2 (Latest)** · [V1](/integrations/v1/docs?lang=fr)

# Private report views

OpenAPI 3.0.3 · API 2.0.0

```json
[
  {
    "url": "https://api.unisoft.world/integrations/v2",
    "description": "API"
  }
]
```

## Opérations

## POST /reports/views

Sauvegarder une définition de rapport privée de la clé API

`create_report_view`

Les objets publics de requête/définition sont limités à 64 Kio. Exige statistics:read, une organisation exacte et une identité stable de clé API. Chaque vue appartient exclusivement à cette clé et cette organisation ; aucun partage avec le personnel, lien public ou héritage administrateur. Les clés restreintes à des campagnes, y compris les restrictions vides ou mal formées, sont refusées. La vue conserve une définition, jamais des résultats ni une autorisation durable. La définition et son exécution revalident les datasets, champs logiques, relations, opérateurs et droits source actuels de l’Explorer. Une référence sauvegardée ne conserve pas un droit révoqué. Droits par dataset : contacts/interactions=contacts:read, paiements=paiements:read, abonnements=abonnements:read, promesses=promesses:read, forms_submit=forms:read ET forms_submit:read, cerfas=receipts:read ; chaque relation utilisée exige ses droits. forms_submit exige un UUID de formulaire actuel non supprimé dans la même organisation. Aucun langage Mongo, pipeline, chemin de base, champ personnalisé ou configuration privée. Découvrir les datasets/champs avec list_explorer_report_datasets et get_explorer_report_dataset. Les unités brutes et devises inconnues restent celles de l’Explorer : paiements/abonnements en mineures, promesses en majeures. Aucune conversion ni formule financière nouvelle. COMPLETED ne prouve pas le règlement bancaire. Aucun prestataire, effet métier ni cache statistique historique. Conserve explicitement une vue privée et exige reports:write. Fournir idempotencyKey (8–100 lettres/chiffres ASCII, underscore ou tiret), name (1–120 caractères après retrait des espaces), kind=rows|aggregate et la requête Explorer publique correspondante. Validation sans exécution. Même clé et entrées initiales : vue actuelle, sans annuler les modifications ultérieures ; entrées différentes : 409 REPORT_VIEW_IDEMPOTENCY_CONFLICT. Une clé supprimée ne recrée pas la vue. Acquittement durable positif obligatoire ; 503 REPORT_VIEW_WRITE_UNCONFIRMED impose d’inspecter cette création idempotente avant une autre tentative. Aucun résultat calculé.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "statistics:read",
  "additional": [
    "reports:write"
  ]
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{8,100}$"
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120
          },
          "kind": {
            "type": "string",
            "enum": [
              "rows",
              "aggregate"
            ]
          },
          "report": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/UnisoftRequest_729f4d152ef616c77bcd"
              },
              {
                "$ref": "#/components/schemas/UnisoftRequest_411efe4dbeaae4a40e62"
              }
            ]
          }
        },
        "required": [
          "idempotencyKey",
          "name",
          "kind",
          "report"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 201

```json
{
  "description": "Réponse de vue privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée invalide ou inconnue.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification requise.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Droit ou principal refusé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Vue, dataset, champ ou formulaire indisponible pour ce principal.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit de révision ou d’idempotence.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 410

```json
{
  "description": "La vue a été supprimée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Définition conservée invalide ou refus du propriétaire.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Stockage/propriétaire indisponible ou écriture non confirmée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "statistics:read",
  "x-unisoft-additional-scopes": [
    "reports:write"
  ],
  "x-unisoft-scopes-by-dataset": {
    "contacts": [
      "contacts:read"
    ],
    "interactions": [
      "contacts:read"
    ],
    "paiements": [
      "paiements:read"
    ],
    "abonnements": [
      "abonnements:read"
    ],
    "promesses": [
      "promesses:read"
    ],
    "forms_submit": [
      "forms_submit:read",
      "forms:read"
    ],
    "cerfas": [
      "receipts:read"
    ]
  },
  "x-unisoft-mcp": {
    "category": "write",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /reports/views

Lister les métadonnées des vues privées

`list_report_views`

Les objets publics de requête/définition sont limités à 64 Kio. Exige statistics:read, une organisation exacte et une identité stable de clé API. Chaque vue appartient exclusivement à cette clé et cette organisation ; aucun partage avec le personnel, lien public ou héritage administrateur. Les clés restreintes à des campagnes, y compris les restrictions vides ou mal formées, sont refusées. La vue conserve une définition, jamais des résultats ni une autorisation durable. La définition et son exécution revalident les datasets, champs logiques, relations, opérateurs et droits source actuels de l’Explorer. Une référence sauvegardée ne conserve pas un droit révoqué. Droits par dataset : contacts/interactions=contacts:read, paiements=paiements:read, abonnements=abonnements:read, promesses=promesses:read, forms_submit=forms:read ET forms_submit:read, cerfas=receipts:read ; chaque relation utilisée exige ses droits. forms_submit exige un UUID de formulaire actuel non supprimé dans la même organisation. Aucun langage Mongo, pipeline, chemin de base, champ personnalisé ou configuration privée. Découvrir les datasets/champs avec list_explorer_report_datasets et get_explorer_report_dataset. Les unités brutes et devises inconnues restent celles de l’Explorer : paiements/abonnements en mineures, promesses en majeures. Aucune conversion ni formule financière nouvelle. COMPLETED ne prouve pas le règlement bancaire. Aucun prestataire, effet métier ni cache statistique historique. GET passif des seules métadonnées privées, sans requête source, calcul, écriture ni définition divulguée. Leur présence ne donne pas le droit d’ouvrir ou exécuter la vue. limit=1..100, défaut 25 ; after reprend nextAfter. Tri croissant par UUID, sans snapshot de pagination ; de nouvelles vues peuvent apparaître. Aucun autre paramètre ni corps non vide.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "statistics:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 100
  },
  "description": "Lignes de métadonnées, défaut 25."
}
```

```json
{
  "name": "after",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "nextAfter de la page de métadonnées précédente."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Réponse de vue privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewListResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée invalide ou inconnue.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification requise.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Droit ou principal refusé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Vue, dataset, champ ou formulaire indisponible pour ce principal.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit de révision ou d’idempotence.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 410

```json
{
  "description": "La vue a été supprimée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Définition conservée invalide ou refus du propriétaire.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Stockage/propriétaire indisponible ou écriture non confirmée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "statistics:read",
  "x-unisoft-additional-scopes": [],
  "x-unisoft-scopes-by-dataset": {
    "contacts": [
      "contacts:read"
    ],
    "interactions": [
      "contacts:read"
    ],
    "paiements": [
      "paiements:read"
    ],
    "abonnements": [
      "abonnements:read"
    ],
    "promesses": [
      "promesses:read"
    ],
    "forms_submit": [
      "forms_submit:read",
      "forms:read"
    ],
    "cerfas": [
      "receipts:read"
    ]
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /reports/views/{viewId}

Lire une définition privée avec les droits actuels

`get_report_view`

Les objets publics de requête/définition sont limités à 64 Kio. Exige statistics:read, une organisation exacte et une identité stable de clé API. Chaque vue appartient exclusivement à cette clé et cette organisation ; aucun partage avec le personnel, lien public ou héritage administrateur. Les clés restreintes à des campagnes, y compris les restrictions vides ou mal formées, sont refusées. La vue conserve une définition, jamais des résultats ni une autorisation durable. La définition et son exécution revalident les datasets, champs logiques, relations, opérateurs et droits source actuels de l’Explorer. Une référence sauvegardée ne conserve pas un droit révoqué. Droits par dataset : contacts/interactions=contacts:read, paiements=paiements:read, abonnements=abonnements:read, promesses=promesses:read, forms_submit=forms:read ET forms_submit:read, cerfas=receipts:read ; chaque relation utilisée exige ses droits. forms_submit exige un UUID de formulaire actuel non supprimé dans la même organisation. Aucun langage Mongo, pipeline, chemin de base, champ personnalisé ou configuration privée. Découvrir les datasets/champs avec list_explorer_report_datasets et get_explorer_report_dataset. Les unités brutes et devises inconnues restent celles de l’Explorer : paiements/abonnements en mineures, promesses en majeures. Aucune conversion ni formule financière nouvelle. COMPLETED ne prouve pas le règlement bancaire. Aucun prestataire, effet métier ni cache statistique historique. GET passif de la définition après validation des droits source et du formulaire actuels, sans calcul ni écriture. Vue absente ou étrangère : 404 REPORT_VIEW_NOT_FOUND. Révocation de droits/champs ou formulaire absent : refus ; redécouvrir les capacités sans contournement. Vue supprimée : 410 REPORT_VIEW_DELETED. Aucun paramètre ni corps non vide.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "statistics:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "viewId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "UUID privé rendu par create_report_view ou list_report_views."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Réponse de vue privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée invalide ou inconnue.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification requise.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Droit ou principal refusé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Vue, dataset, champ ou formulaire indisponible pour ce principal.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit de révision ou d’idempotence.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 410

```json
{
  "description": "La vue a été supprimée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Définition conservée invalide ou refus du propriétaire.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Stockage/propriétaire indisponible ou écriture non confirmée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "statistics:read",
  "x-unisoft-additional-scopes": [],
  "x-unisoft-scopes-by-dataset": {
    "contacts": [
      "contacts:read"
    ],
    "interactions": [
      "contacts:read"
    ],
    "paiements": [
      "paiements:read"
    ],
    "abonnements": [
      "abonnements:read"
    ],
    "promesses": [
      "promesses:read"
    ],
    "forms_submit": [
      "forms_submit:read",
      "forms:read"
    ],
    "cerfas": [
      "receipts:read"
    ]
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## PATCH /reports/views/{viewId}

Modifier une définition de rapport privée

`update_report_view`

Les objets publics de requête/définition sont limités à 64 Kio. Exige statistics:read, une organisation exacte et une identité stable de clé API. Chaque vue appartient exclusivement à cette clé et cette organisation ; aucun partage avec le personnel, lien public ou héritage administrateur. Les clés restreintes à des campagnes, y compris les restrictions vides ou mal formées, sont refusées. La vue conserve une définition, jamais des résultats ni une autorisation durable. La définition et son exécution revalident les datasets, champs logiques, relations, opérateurs et droits source actuels de l’Explorer. Une référence sauvegardée ne conserve pas un droit révoqué. Droits par dataset : contacts/interactions=contacts:read, paiements=paiements:read, abonnements=abonnements:read, promesses=promesses:read, forms_submit=forms:read ET forms_submit:read, cerfas=receipts:read ; chaque relation utilisée exige ses droits. forms_submit exige un UUID de formulaire actuel non supprimé dans la même organisation. Aucun langage Mongo, pipeline, chemin de base, champ personnalisé ou configuration privée. Découvrir les datasets/champs avec list_explorer_report_datasets et get_explorer_report_dataset. Les unités brutes et devises inconnues restent celles de l’Explorer : paiements/abonnements en mineures, promesses en majeures. Aucune conversion ni formule financière nouvelle. COMPLETED ne prouve pas le règlement bancaire. Aucun prestataire, effet métier ni cache statistique historique. Modifie explicitement name et/ou report avec reports:write et droits source actuels. Fournir revision et au moins un champ modifié. kind est immuable. Le validateur public Explorer est réutilisé sans calcul. Révision et propriété scalaire sont vérifiées atomiquement ; révision obsolète : 409 REPORT_VIEW_REVISION_CONFLICT. Le succès donne la révision suivante. 503 REPORT_VIEW_WRITE_UNCONFIRMED : relire la vue pour résoudre sa révision avant une nouvelle commande, sans répétition aveugle.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "statistics:read",
  "additional": [
    "reports:write"
  ]
}
```

### Paramètres

```json
{
  "name": "viewId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "UUID privé rendu par create_report_view ou list_report_views."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "revision": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120
          },
          "report": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/UnisoftRequest_729f4d152ef616c77bcd"
              },
              {
                "$ref": "#/components/schemas/UnisoftRequest_411efe4dbeaae4a40e62"
              }
            ]
          }
        },
        "required": [
          "revision"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Réponse de vue privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée invalide ou inconnue.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification requise.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Droit ou principal refusé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Vue, dataset, champ ou formulaire indisponible pour ce principal.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit de révision ou d’idempotence.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 410

```json
{
  "description": "La vue a été supprimée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Définition conservée invalide ou refus du propriétaire.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Stockage/propriétaire indisponible ou écriture non confirmée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "statistics:read",
  "x-unisoft-additional-scopes": [
    "reports:write"
  ],
  "x-unisoft-scopes-by-dataset": {
    "contacts": [
      "contacts:read"
    ],
    "interactions": [
      "contacts:read"
    ],
    "paiements": [
      "paiements:read"
    ],
    "abonnements": [
      "abonnements:read"
    ],
    "promesses": [
      "promesses:read"
    ],
    "forms_submit": [
      "forms_submit:read",
      "forms:read"
    ],
    "cerfas": [
      "receipts:read"
    ]
  },
  "x-unisoft-mcp": {
    "category": "write",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

## DELETE /reports/views/{viewId}

Supprimer une définition de rapport privée

`delete_report_view`

Les objets publics de requête/définition sont limités à 64 Kio. Exige statistics:read, une organisation exacte et une identité stable de clé API. Chaque vue appartient exclusivement à cette clé et cette organisation ; aucun partage avec le personnel, lien public ou héritage administrateur. Les clés restreintes à des campagnes, y compris les restrictions vides ou mal formées, sont refusées. La vue conserve une définition, jamais des résultats ni une autorisation durable. La définition et son exécution revalident les datasets, champs logiques, relations, opérateurs et droits source actuels de l’Explorer. Une référence sauvegardée ne conserve pas un droit révoqué. Droits par dataset : contacts/interactions=contacts:read, paiements=paiements:read, abonnements=abonnements:read, promesses=promesses:read, forms_submit=forms:read ET forms_submit:read, cerfas=receipts:read ; chaque relation utilisée exige ses droits. forms_submit exige un UUID de formulaire actuel non supprimé dans la même organisation. Aucun langage Mongo, pipeline, chemin de base, champ personnalisé ou configuration privée. Découvrir les datasets/champs avec list_explorer_report_datasets et get_explorer_report_dataset. Les unités brutes et devises inconnues restent celles de l’Explorer : paiements/abonnements en mineures, promesses en majeures. Aucune conversion ni formule financière nouvelle. COMPLETED ne prouve pas le règlement bancaire. Aucun prestataire, effet métier ni cache statistique historique. Supprime explicitement cette vue privée avec reports:write et revision actuelle. Une tombstone ne garde que propriété/idempotence/révision ; nom et filtres sont effacés. Les éventuels exports/jobs sont des objets privés distincts. Révision obsolète : 409. 503 REPORT_VIEW_WRITE_UNCONFIRMED impose d’inspecter l’état avant une nouvelle commande. Aucune lecture source ni calcul nécessaire.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "statistics:read",
  "additional": [
    "reports:write"
  ]
}
```

### Paramètres

```json
{
  "name": "viewId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "UUID privé rendu par create_report_view ou list_report_views."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "revision": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          }
        },
        "required": [
          "revision"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Réponse de vue privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewDeleteResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée invalide ou inconnue.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification requise.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Droit ou principal refusé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Vue, dataset, champ ou formulaire indisponible pour ce principal.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit de révision ou d’idempotence.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 410

```json
{
  "description": "La vue a été supprimée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Définition conservée invalide ou refus du propriétaire.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Stockage/propriétaire indisponible ou écriture non confirmée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "statistics:read",
  "x-unisoft-additional-scopes": [
    "reports:write"
  ],
  "x-unisoft-scopes-by-dataset": {
    "contacts": [
      "contacts:read"
    ],
    "interactions": [
      "contacts:read"
    ],
    "paiements": [
      "paiements:read"
    ],
    "abonnements": [
      "abonnements:read"
    ],
    "promesses": [
      "promesses:read"
    ],
    "forms_submit": [
      "forms_submit:read",
      "forms:read"
    ],
    "cerfas": [
      "receipts:read"
    ]
  },
  "x-unisoft-mcp": {
    "category": "write",
    "readOnly": false,
    "destructive": true,
    "idempotent": false,
    "warn": true
  }
}
```

## POST /reports/views/{viewId}/run

Exécuter la définition privée actuelle

`run_report_view`

Les objets publics de requête/définition sont limités à 64 Kio. Exige statistics:read, une organisation exacte et une identité stable de clé API. Chaque vue appartient exclusivement à cette clé et cette organisation ; aucun partage avec le personnel, lien public ou héritage administrateur. Les clés restreintes à des campagnes, y compris les restrictions vides ou mal formées, sont refusées. La vue conserve une définition, jamais des résultats ni une autorisation durable. La définition et son exécution revalident les datasets, champs logiques, relations, opérateurs et droits source actuels de l’Explorer. Une référence sauvegardée ne conserve pas un droit révoqué. Droits par dataset : contacts/interactions=contacts:read, paiements=paiements:read, abonnements=abonnements:read, promesses=promesses:read, forms_submit=forms:read ET forms_submit:read, cerfas=receipts:read ; chaque relation utilisée exige ses droits. forms_submit exige un UUID de formulaire actuel non supprimé dans la même organisation. Aucun langage Mongo, pipeline, chemin de base, champ personnalisé ou configuration privée. Découvrir les datasets/champs avec list_explorer_report_datasets et get_explorer_report_dataset. Les unités brutes et devises inconnues restent celles de l’Explorer : paiements/abonnements en mineures, promesses en majeures. Aucune conversion ni formule financière nouvelle. COMPLETED ne prouve pas le règlement bancaire. Aucun prestataire, effet métier ni cache statistique historique. Exécute explicitement la définition actuelle via le propriétaire Explorer public, avec droits source et formulaire actuels. reports:write inutile car rien n’est conservé. Pour rows, page=1..500 et pageSize=1..200 peuvent surcharger cet appel seulement ; aggregate exige un objet vide. viewRevision identifie la définition. Les résultats sont des observations avec consistentSnapshot=false, sourceComputedAt inconnu et aucun cache historique. Aucun paramètre de requête.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "statistics:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "viewId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "UUID privé rendu par create_report_view ou list_report_views."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "minimum": 1,
            "maximum": 500
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 200
          }
        },
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Réponse de vue privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewRunResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Entrée invalide ou inconnue.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification requise.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Droit ou principal refusé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Vue, dataset, champ ou formulaire indisponible pour ce principal.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit de révision ou d’idempotence.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 410

```json
{
  "description": "La vue a été supprimée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Définition conservée invalide ou refus du propriétaire.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Stockage/propriétaire indisponible ou écriture non confirmée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportViewError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "statistics:read",
  "x-unisoft-additional-scopes": [],
  "x-unisoft-scopes-by-dataset": {
    "contacts": [
      "contacts:read"
    ],
    "interactions": [
      "contacts:read"
    ],
    "paiements": [
      "paiements:read"
    ],
    "abonnements": [
      "abonnements:read"
    ],
    "promesses": [
      "promesses:read"
    ],
    "forms_submit": [
      "forms_submit:read",
      "forms:read"
    ],
    "cerfas": [
      "receipts:read"
    ]
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## Schémas

```json
{
  "components": {
    "schemas": {
      "UnisoftRequest_729f4d152ef616c77bcd": {
        "type": "object",
        "properties": {
          "dataset": {
            "type": "string",
            "enum": [
              "contacts",
              "interactions",
              "paiements",
              "abonnements",
              "promesses",
              "forms_submit",
              "cerfas"
            ]
          },
          "formId": {
            "type": "string",
            "format": "uuid",
            "description": "Obligatoire seulement pour forms_submit, dont la granularité prise en charge est submission. Les autres jeux de données refusent formId."
          },
          "filters": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "object",
              "properties": {
                "field": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 180,
                  "description": "Identifiant logique exact de champ annoncé dans le catalogue autorisé de ce jeu de données ; jamais un chemin de base de données ni une expression."
                },
                "op": {
                  "type": "string",
                  "enum": [
                    "contains",
                    "equals",
                    "startsWith",
                    "endsWith",
                    "in",
                    "notIn",
                    "eq",
                    "neq",
                    "gt",
                    "gte",
                    "lt",
                    "lte",
                    "between",
                    "before",
                    "after",
                    "isTrue",
                    "isFalse",
                    "isEmpty",
                    "isNotEmpty"
                  ]
                },
                "values": {
                  "type": "array",
                  "maxItems": 20,
                  "items": {
                    "oneOf": [
                      {
                        "type": "string",
                        "maxLength": 500
                      },
                      {
                        "type": "number"
                      }
                    ]
                  }
                }
              },
              "required": [
                "field",
                "op",
                "values"
              ],
              "additionalProperties": false
            }
          },
          "fields": {
            "type": "array",
            "minItems": 1,
            "maxItems": 40,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 180,
              "description": "Identifiant logique exact de champ annoncé dans le catalogue autorisé de ce jeu de données ; jamais un chemin de base de données ni une expression."
            }
          },
          "sort": {
            "type": "array",
            "maxItems": 4,
            "items": {
              "type": "object",
              "properties": {
                "field": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 180,
                  "description": "Identifiant logique exact de champ annoncé dans le catalogue autorisé de ce jeu de données ; jamais un chemin de base de données ni une expression."
                },
                "order": {
                  "type": "string",
                  "enum": [
                    "asc",
                    "desc"
                  ]
                }
              },
              "required": [
                "field",
                "order"
              ],
              "additionalProperties": false
            }
          },
          "page": {
            "type": "integer",
            "minimum": 1,
            "maximum": 500,
            "default": 1
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 200,
            "default": 50
          }
        },
        "required": [
          "dataset",
          "fields"
        ],
        "additionalProperties": false
      },
      "UnisoftRequest_411efe4dbeaae4a40e62": {
        "type": "object",
        "properties": {
          "dataset": {
            "type": "string",
            "enum": [
              "contacts",
              "interactions",
              "paiements",
              "abonnements",
              "promesses",
              "forms_submit",
              "cerfas"
            ]
          },
          "formId": {
            "type": "string",
            "format": "uuid",
            "description": "Obligatoire seulement pour forms_submit, dont la granularité prise en charge est submission. Les autres jeux de données refusent formId."
          },
          "filters": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "object",
              "properties": {
                "field": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 180,
                  "description": "Identifiant logique exact de champ annoncé dans le catalogue autorisé de ce jeu de données ; jamais un chemin de base de données ni une expression."
                },
                "op": {
                  "type": "string",
                  "enum": [
                    "contains",
                    "equals",
                    "startsWith",
                    "endsWith",
                    "in",
                    "notIn",
                    "eq",
                    "neq",
                    "gt",
                    "gte",
                    "lt",
                    "lte",
                    "between",
                    "before",
                    "after",
                    "isTrue",
                    "isFalse",
                    "isEmpty",
                    "isNotEmpty"
                  ]
                },
                "values": {
                  "type": "array",
                  "maxItems": 20,
                  "items": {
                    "oneOf": [
                      {
                        "type": "string",
                        "maxLength": 500
                      },
                      {
                        "type": "number"
                      }
                    ]
                  }
                }
              },
              "required": [
                "field",
                "op",
                "values"
              ],
              "additionalProperties": false
            }
          },
          "operation": {
            "type": "string",
            "enum": [
              "count",
              "sum",
              "avg",
              "min",
              "max"
            ]
          },
          "field": {
            "type": "string",
            "minLength": 1,
            "maxLength": 180,
            "description": "Obligatoire pour sum/avg/min/max, interdit pour count. Seul un champ NUMBER racine ou calculé avec numericAggregate:true est accepté ; les métriques MONEY et de relation ne sont pas prises en charge."
          },
          "groupBy": {
            "type": "string",
            "minLength": 1,
            "maxLength": 180,
            "description": "Champ regroupable unique facultatif. L’omettre pour une valeur globale. Aucun regroupement sur plusieurs axes ou par intervalle de date, aucune expression ni agrégation monétaire n’est accepté."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 30,
            "default": 12
          }
        },
        "required": [
          "dataset",
          "operation"
        ],
        "additionalProperties": false
      },
      "ReportViewResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ReportViewDefinition"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "ReportViewDefinition": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120
          },
          "kind": {
            "type": "string",
            "enum": [
              "rows",
              "aggregate"
            ]
          },
          "revision": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "visibility": {
            "type": "string",
            "enum": [
              "API_KEY_PRIVATE"
            ]
          },
          "report": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/ExplorerReportRunRequest"
              },
              {
                "$ref": "#/components/schemas/ExplorerReportAggregateRequest"
              }
            ]
          }
        },
        "required": [
          "id",
          "name",
          "kind",
          "revision",
          "createdAt",
          "updatedAt",
          "visibility",
          "report"
        ]
      },
      "ExplorerReportRunRequest": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "dataset": {
            "type": "string",
            "enum": [
              "contacts",
              "interactions",
              "paiements",
              "abonnements",
              "promesses",
              "forms_submit",
              "cerfas"
            ]
          },
          "formId": {
            "type": "string",
            "format": "uuid",
            "description": "Obligatoire seulement pour forms_submit, dont la granularité prise en charge est submission. Les autres jeux de données refusent formId."
          },
          "filters": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "$ref": "#/components/schemas/ExplorerReportFilter"
            }
          },
          "fields": {
            "type": "array",
            "minItems": 1,
            "maxItems": 40,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 180,
              "description": "Identifiant logique exact de champ annoncé dans le catalogue autorisé de ce jeu de données ; jamais un chemin de base de données ni une expression."
            }
          },
          "sort": {
            "type": "array",
            "maxItems": 4,
            "items": {
              "$ref": "#/components/schemas/ExplorerReportSort"
            }
          },
          "page": {
            "type": "integer",
            "minimum": 1,
            "maximum": 500,
            "default": 1
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 200,
            "default": 50
          }
        },
        "required": [
          "dataset",
          "fields"
        ]
      },
      "ExplorerReportFilter": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "field": {
            "type": "string",
            "minLength": 1,
            "maxLength": 180,
            "description": "Identifiant logique exact de champ annoncé dans le catalogue autorisé de ce jeu de données ; jamais un chemin de base de données ni une expression."
          },
          "op": {
            "type": "string",
            "enum": [
              "contains",
              "equals",
              "startsWith",
              "endsWith",
              "in",
              "notIn",
              "eq",
              "neq",
              "gt",
              "gte",
              "lt",
              "lte",
              "between",
              "before",
              "after",
              "isTrue",
              "isFalse",
              "isEmpty",
              "isNotEmpty"
            ]
          },
          "values": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "oneOf": [
                {
                  "type": "string",
                  "maxLength": 500
                },
                {
                  "type": "number"
                }
              ]
            }
          }
        },
        "required": [
          "field",
          "op",
          "values"
        ]
      },
      "ExplorerReportSort": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "field": {
            "type": "string",
            "minLength": 1,
            "maxLength": 180,
            "description": "Identifiant logique exact de champ annoncé dans le catalogue autorisé de ce jeu de données ; jamais un chemin de base de données ni une expression."
          },
          "order": {
            "type": "string",
            "enum": [
              "asc",
              "desc"
            ]
          }
        },
        "required": [
          "field",
          "order"
        ]
      },
      "ExplorerReportAggregateRequest": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "dataset": {
            "type": "string",
            "enum": [
              "contacts",
              "interactions",
              "paiements",
              "abonnements",
              "promesses",
              "forms_submit",
              "cerfas"
            ]
          },
          "formId": {
            "type": "string",
            "format": "uuid",
            "description": "Obligatoire seulement pour forms_submit, dont la granularité prise en charge est submission. Les autres jeux de données refusent formId."
          },
          "filters": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "$ref": "#/components/schemas/ExplorerReportFilter"
            }
          },
          "operation": {
            "type": "string",
            "enum": [
              "count",
              "sum",
              "avg",
              "min",
              "max"
            ]
          },
          "field": {
            "type": "string",
            "minLength": 1,
            "maxLength": 180,
            "description": "Obligatoire pour sum/avg/min/max, interdit pour count. Seul un champ NUMBER racine ou calculé avec numericAggregate:true est accepté ; les métriques MONEY et de relation ne sont pas prises en charge."
          },
          "groupBy": {
            "type": "string",
            "minLength": 1,
            "maxLength": 180,
            "description": "Champ regroupable unique facultatif. L’omettre pour une valeur globale. Aucun regroupement sur plusieurs axes ou par intervalle de date, aucune expression ni agrégation monétaire n’est accepté."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 30,
            "default": 12
          }
        },
        "required": [
          "dataset",
          "operation"
        ]
      },
      "ReportViewError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      },
      "ReportViewListResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ReportViewList"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "ReportViewList": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "items": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/ReportViewMetadata"
            }
          },
          "hasMore": {
            "type": "boolean"
          },
          "nextAfter": {
            "type": "string",
            "nullable": true,
            "format": "uuid"
          },
          "consistentSnapshot": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        },
        "required": [
          "items",
          "hasMore",
          "nextAfter",
          "consistentSnapshot"
        ]
      },
      "ReportViewMetadata": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120
          },
          "kind": {
            "type": "string",
            "enum": [
              "rows",
              "aggregate"
            ]
          },
          "revision": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "visibility": {
            "type": "string",
            "enum": [
              "API_KEY_PRIVATE"
            ]
          }
        },
        "required": [
          "id",
          "name",
          "kind",
          "revision",
          "createdAt",
          "updatedAt",
          "visibility"
        ]
      },
      "ReportViewDeleteResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ReportViewDeleted"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "ReportViewDeleted": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "revision": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "deleted": {
            "type": "boolean",
            "enum": [
              true
            ]
          }
        },
        "required": [
          "id",
          "revision",
          "deleted"
        ]
      },
      "ReportViewRunResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ReportViewRunResult"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "ReportViewRunResult": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "viewId": {
            "type": "string",
            "format": "uuid"
          },
          "viewRevision": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "kind": {
            "type": "string",
            "enum": [
              "rows",
              "aggregate"
            ]
          },
          "result": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/ReportViewExplorerRunResult"
              },
              {
                "$ref": "#/components/schemas/ExplorerReportAggregateResult"
              }
            ]
          }
        },
        "required": [
          "viewId",
          "viewRevision",
          "kind",
          "result"
        ]
      },
      "ReportViewExplorerRunResult": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "dataset": {
            "type": "string"
          },
          "columns": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ExplorerReportField"
            }
          },
          "rows": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/ReportViewExplorerRow"
            }
          },
          "total": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "page": {
            "type": "integer"
          },
          "pageSize": {
            "type": "integer"
          },
          "hasMore": {
            "type": "boolean"
          },
          "readAt": {
            "type": "string",
            "format": "date-time"
          },
          "sourceComputedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "freshness": {
            "type": "string",
            "enum": [
              "LIVE_QUERY"
            ]
          },
          "consistentSnapshot": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        },
        "required": [
          "dataset",
          "columns",
          "rows",
          "total",
          "page",
          "pageSize",
          "hasMore",
          "readAt",
          "sourceComputedAt",
          "freshness",
          "consistentSnapshot"
        ]
      },
      "ExplorerReportField": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "field": {
            "type": "string",
            "minLength": 1,
            "maxLength": 180,
            "description": "Identifiant logique exact de champ annoncé dans le catalogue autorisé de ce jeu de données ; jamais un chemin de base de données ni une expression."
          },
          "type": {
            "type": "string",
            "enum": [
              "TEXT",
              "NUMBER",
              "MONEY",
              "DATE",
              "DATETIME",
              "BOOL",
              "ENUM",
              "REF"
            ]
          },
          "label": {
            "type": "string"
          },
          "filterable": {
            "type": "boolean"
          },
          "sortable": {
            "type": "boolean"
          },
          "groupable": {
            "type": "boolean"
          },
          "numericAggregate": {
            "type": "boolean"
          },
          "operators": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "unit": {
            "type": "string",
            "nullable": true,
            "enum": [
              "NUMBER",
              "MINOR_CURRENCY_UNIT",
              "MAJOR_CURRENCY_UNIT",
              null
            ]
          }
        },
        "required": [
          "field",
          "type",
          "label",
          "filterable",
          "sortable",
          "groupable",
          "numericAggregate",
          "operators",
          "unit"
        ]
      },
      "ReportViewExplorerRow": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "values": {
            "type": "object",
            "additionalProperties": {
              "oneOf": [
                {
                  "type": "string",
                  "maxLength": 2000,
                  "nullable": true
                },
                {
                  "type": "number"
                },
                {
                  "type": "boolean"
                }
              ]
            },
            "description": "Uniquement les identifiants logiques de champs demandés. Les valeurs conservent les unités brutes du propriétaire. Les valeurs stockées non prises en charge ou invalides valent null ; aucun document brut ni instantané imbriqué n’est renvoyé.",
            "maxProperties": 40,
            "x-unisoft-map-key-pattern": "^(?:_computed\\.actionsCount|_computed\\.adressesCount|_computed\\.age|_computed\\.civilite|_computed\\.emailsCount|_computed\\.fullName|_computed\\.genre|_computed\\.hasContent|_computed\\.hasType|_computed\\.telsCount|abonnements\\._agg\\.count|abonnements\\._agg\\.firstDate|abonnements\\._agg\\.lastDate|abonnements\\.active|abonnements\\.amount|abonnements\\.assoc|abonnements\\.canceledAt|abonnements\\.datetime|abonnements\\.devise|abonnements\\.id|abonnements\\.max|abonnements\\.method|abonnements\\.name|abonnements\\.nb|abonnements\\.platform|abonnements\\.recurrentType|abonnements\\.retry|abonnements\\.state|abonnements\\.type|cerfa\\._agg\\.count|cerfa\\._agg\\.firstDate|cerfa\\._agg\\.lastDate|cerfa\\.datetime|cerfa\\.id|cerfa\\.num|cerfa\\.year|contact\\._agg\\.count|contact\\._agg\\.firstDate|contact\\._agg\\.lastDate|contact\\.adresse|contact\\.adressesCount|contact\\.age|contact\\.archived|contact\\.civilite|contact\\.datetime|contact\\.ddn|contact\\.deceased|contact\\.deceasedDate|contact\\.editDatetime|contact\\.email|contact\\.emailsCount|contact\\.etat|contact\\.fullName|contact\\.genre|contact\\.giftAid|contact\\.homme|contact\\.id|contact\\.new|contact\\.nom|contact\\.nomHebreu|contact\\.nomJF|contact\\.pays|contact\\.postal|contact\\.prenom|contact\\.prenomHE|contact\\.route|contact\\.tel|contact\\.telsCount|contact\\.tribu|contact\\.ville|forms_submit\\._agg\\.count|forms_submit\\._agg\\.firstDate|forms_submit\\._agg\\.lastDate|forms_submit\\.archived|forms_submit\\.datetime|forms_submit\\.devise|forms_submit\\.editDatetime|forms_submit\\.formId|forms_submit\\.formLabel|forms_submit\\.formType|forms_submit\\.id|forms_submit\\.identityEmail|forms_submit\\.identityNom|forms_submit\\.identityPrenom|forms_submit\\.identityTel|forms_submit\\.paiementMethod|forms_submit\\.state|interactions\\._agg\\.count|interactions\\._agg\\.firstDate|interactions\\._agg\\.lastDate|interactions\\.actionsCount|interactions\\.content|interactions\\.datePrecision|interactions\\.datetime|interactions\\.editDatetime|interactions\\.hasContent|interactions\\.hasType|interactions\\.id|interactions\\.occurredOn|interactions\\.type|paiements\\._agg\\.count|paiements\\._agg\\.firstDate|paiements\\._agg\\.lastDate|paiements\\.amount|paiements\\.assoc|paiements\\.commentaire|paiements\\.datetime|paiements\\.devise|paiements\\.editDatetime|paiements\\.id|paiements\\.infoEmail|paiements\\.infoHomme|paiements\\.infoNom|paiements\\.infoPrenom|paiements\\.infoTel|paiements\\.method|paiements\\.name|paiements\\.platform|paiements\\.source|paiements\\.type|promesses\\._agg\\.count|promesses\\._agg\\.firstDate|promesses\\._agg\\.lastDate|promesses\\.active|promesses\\.assoc|promesses\\.date|promesses\\.datetime|promesses\\.devise|promesses\\.editDatetime|promesses\\.id|promesses\\.montant|promesses\\.name|promesses\\.occasion|promesses\\.state|promesses\\.type|root\\.active|root\\.adresse|root\\.amount|root\\.archived|root\\.assoc|root\\.canceledAt|root\\.commentaire|root\\.content|root\\.date|root\\.datePrecision|root\\.datetime|root\\.ddn|root\\.deceased|root\\.deceasedDate|root\\.devise|root\\.editDatetime|root\\.email|root\\.etat|root\\.formId|root\\.formLabel|root\\.formType|root\\.giftAid|root\\.homme|root\\.id|root\\.identityEmail|root\\.identityNom|root\\.identityPrenom|root\\.identityTel|root\\.infoEmail|root\\.infoHomme|root\\.infoNom|root\\.infoPrenom|root\\.infoTel|root\\.max|root\\.method|root\\.montant|root\\.name|root\\.nb|root\\.new|root\\.nom|root\\.nomHebreu|root\\.nomJF|root\\.num|root\\.occasion|root\\.occurredOn|root\\.paiementMethod|root\\.pays|root\\.platform|root\\.postal|root\\.prenom|root\\.prenomHE|root\\.recurrentType|root\\.retry|root\\.route|root\\.source|root\\.state|root\\.tel|root\\.tribu|root\\.type|root\\.ville|root\\.year)$"
          },
          "currencies": {
            "type": "object",
            "additionalProperties": {
              "type": "string",
              "nullable": true,
              "pattern": "^[a-z]{3}$"
            },
            "description": "Devise de chaque champ MONEY sélectionné, ou null si elle est indisponible. Aucune devise d’organisation n’est inventée.",
            "maxProperties": 40,
            "x-unisoft-map-key-pattern": "^(?:root\\.(?:amount|montant)|(?:paiements|abonnements)\\.amount|promesses\\.montant)$"
          }
        },
        "required": [
          "values",
          "currencies"
        ]
      },
      "ExplorerReportAggregateResult": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "dataset": {
            "type": "string"
          },
          "operation": {
            "type": "string",
            "enum": [
              "count",
              "sum",
              "avg",
              "min",
              "max"
            ]
          },
          "field": {
            "type": "string",
            "nullable": true
          },
          "groupBy": {
            "type": "string",
            "nullable": true
          },
          "items": {
            "type": "array",
            "maxItems": 30,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "group": {
                  "oneOf": [
                    {
                      "type": "string",
                      "maxLength": 2000,
                      "nullable": true
                    },
                    {
                      "type": "number"
                    },
                    {
                      "type": "boolean"
                    }
                  ]
                },
                "count": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "nullable": true
                },
                "value": {
                  "type": "number",
                  "nullable": true
                }
              },
              "required": [
                "group",
                "count",
                "value"
              ]
            }
          },
          "value": {
            "type": "number",
            "nullable": true
          },
          "count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "valueCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true
          },
          "truncated": {
            "type": "boolean"
          },
          "readAt": {
            "type": "string",
            "format": "date-time"
          },
          "sourceComputedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "freshness": {
            "type": "string",
            "enum": [
              "LIVE_QUERY"
            ]
          },
          "consistentSnapshot": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        },
        "required": [
          "dataset",
          "operation",
          "field",
          "groupBy",
          "items",
          "value",
          "count",
          "valueCount",
          "truncated",
          "readAt",
          "sourceComputedAt",
          "freshness",
          "consistentSnapshot"
        ]
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
