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

# Durable report tasks

OpenAPI 3.0.3 · API 2.0.0

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

## Opérations

## POST /ai-tasks/report-export

Démarrer un export de rapport privé durable

`start_report_export_task`

Pilote de tâches durables d’export de rapports activé explicitement. Les installations où il est désactivé renvoient 503 MCP_TASKS_DISABLED sans appeler le moteur de tâches ni la source du rapport. Chaque tâche appartient exclusivement à la clé API d’organisation authentifiée ; les identifiants root, système ou limités à certaines campagnes sont refusés. Les identifiants actuels, l’organisation et toutes les permissions des sources sont revérifiés avant chaque divulgation ou commande. Exige statistics:read ainsi que les permissions des jeux de données et relations sources : contacts/interactions=contacts:read, paiements=paiements:read, abonnements=abonnements:read, promesses=promesses:read, forms_submit=forms:read AND forms_submit:read, cerfas=receipts:read. forms_submit exige aussi l’UUID d’un formulaire actuel non supprimé de la même organisation. Utiliser le catalogue Explorer autorisé. Le ReportExportRequest existant est réutilisé sans modification : une page demandée de 200 lignes au maximum ou un agrégat limité à 30 groupes au maximum, jamais un jeu de données complet ni un instantané transactionnel. Les unités brutes, devises, limites de format et restrictions de caractères PDF existantes restent applicables. Aucune opération financière, aucun email ni partage public n’est créé. Le pilote expire à l’échéance de sa source, au plus 600 secondes après la création ; le plafond général de 7 jours après la fin ne prolonge pas cette durée plus courte. Les lectures, répétitions et reconnexions ne renouvellent jamais l’expiration. Aucune étape de confirmation Unisoft supplémentaire ; l’hôte IA gère ses propres approbations d’écriture.

Exige reports:write en plus de statistics:read. Envoyer le corps ReportExportCreate exact avec idempotencyKey et request. Un worker durable exécute l’export existant à exécution unique. Répéter la même clé avec la même requête renvoie la même tâche, dans son état actuel quel qu’il soit ; des entrées différentes renvoient 409. Conserver cette clé après une réponse incertaine et consulter la même tâche. Ne jamais créer de remplacement simplement parce qu’un worker ou une réponse tarde. Un verrou RUNNING conservé sur la source n’est jamais repris et son travail n’est jamais exécuté de nouveau automatiquement.

### 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}$"
          },
          "request": {
            "type": "object",
            "properties": {
              "format": {
                "type": "string",
                "enum": [
                  "json",
                  "csv",
                  "xlsx",
                  "pdf"
                ]
              },
              "kind": {
                "type": "string",
                "enum": [
                  "rows",
                  "aggregate"
                ]
              },
              "report": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/UnisoftRequest_729f4d152ef616c77bcd"
                  },
                  {
                    "$ref": "#/components/schemas/UnisoftRequest_411efe4dbeaae4a40e62"
                  }
                ]
              }
            },
            "required": [
              "format",
              "kind",
              "report"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "idempotencyKey",
          "request"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 201

```json
{
  "description": "État de la tâche privée durable et métadonnées éventuelles de l’artefact figé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Paramètre de requête invalide ou inconnu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

```json
{
  "description": "Identité actuelle ou permissions requises refusées.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Tâche privée ou source autorisée indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit d’idempotence, verrou d’exécution conservé ou artefact pas encore disponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 410

```json
{
  "description": "Tâche ou source expirée ; aucun renouvellement n’est effectué.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Champs sources, format, intégrité du fichier ou limite de sortie refusés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 429

```json
{
  "description": "Quota actuel de tâches privées atteint ; consulter les tâches existantes avant de démarrer un autre export.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Pilote de tâches désactivé, stockage indisponible ou accusé de réception de commande incertain ; consulter la même tâche avant de résoudre l’incertitude.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

### OpenAPI

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

## GET /ai-tasks/{taskId}

Lire une tâche privée durable

`get_unisoft_task`

Pilote de tâches durables d’export de rapports activé explicitement. Les installations où il est désactivé renvoient 503 MCP_TASKS_DISABLED sans appeler le moteur de tâches ni la source du rapport. Chaque tâche appartient exclusivement à la clé API d’organisation authentifiée ; les identifiants root, système ou limités à certaines campagnes sont refusés. Les identifiants actuels, l’organisation et toutes les permissions des sources sont revérifiés avant chaque divulgation ou commande. Exige statistics:read ainsi que les permissions des jeux de données et relations sources : contacts/interactions=contacts:read, paiements=paiements:read, abonnements=abonnements:read, promesses=promesses:read, forms_submit=forms:read AND forms_submit:read, cerfas=receipts:read. forms_submit exige aussi l’UUID d’un formulaire actuel non supprimé de la même organisation. Utiliser le catalogue Explorer autorisé. Le ReportExportRequest existant est réutilisé sans modification : une page demandée de 200 lignes au maximum ou un agrégat limité à 30 groupes au maximum, jamais un jeu de données complet ni un instantané transactionnel. Les unités brutes, devises, limites de format et restrictions de caractères PDF existantes restent applicables. Aucune opération financière, aucun email ni partage public n’est créé. Le pilote expire à l’échéance de sa source, au plus 600 secondes après la création ; le plafond général de 7 jours après la fin ne prolonge pas cette durée plus courte. Les lectures, répétitions et reconnexions ne renouvellent jamais l’expiration. Aucune étape de confirmation Unisoft supplémentaire ; l’hôte IA gère ses propres approbations d’écriture.

Lecture passive de l’état. Ne lance jamais de rapport, ne génère jamais de fichier, ne retente jamais l’exécution, ne renouvelle jamais l’expiration et ne nettoie jamais le stockage. COMPLETED expose uniquement les métadonnées de l’artefact figé ; FAILED porte un code stable. L’artefact reste accessible uniquement tant que les droits actuels sur les sources et l’échéance initiale restent valides. Une autre clé ou organisation ne se distingue pas d’une tâche inconnue.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "taskId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "UUID de tâche privée renvoyé par start_report_export_task."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "État de la tâche privée durable et métadonnées éventuelles de l’artefact figé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Paramètre de requête invalide ou inconnu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

```json
{
  "description": "Identité actuelle ou permissions requises refusées.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Tâche privée ou source autorisée indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit d’idempotence, verrou d’exécution conservé ou artefact pas encore disponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 410

```json
{
  "description": "Tâche ou source expirée ; aucun renouvellement n’est effectué.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Champs sources, format, intégrité du fichier ou limite de sortie refusés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 429

```json
{
  "description": "Quota actuel de tâches privées atteint ; consulter les tâches existantes avant de démarrer un autre export.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Pilote de tâches désactivé, stockage indisponible ou accusé de réception de commande incertain ; consulter la même tâche avant de résoudre l’incertitude.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

### OpenAPI

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

## POST /ai-tasks/{taskId}/cancel

Demander l’annulation d’une tâche privée durable

`cancel_unisoft_task`

Pilote de tâches durables d’export de rapports activé explicitement. Les installations où il est désactivé renvoient 503 MCP_TASKS_DISABLED sans appeler le moteur de tâches ni la source du rapport. Chaque tâche appartient exclusivement à la clé API d’organisation authentifiée ; les identifiants root, système ou limités à certaines campagnes sont refusés. Les identifiants actuels, l’organisation et toutes les permissions des sources sont revérifiés avant chaque divulgation ou commande. Exige statistics:read ainsi que les permissions des jeux de données et relations sources : contacts/interactions=contacts:read, paiements=paiements:read, abonnements=abonnements:read, promesses=promesses:read, forms_submit=forms:read AND forms_submit:read, cerfas=receipts:read. forms_submit exige aussi l’UUID d’un formulaire actuel non supprimé de la même organisation. Utiliser le catalogue Explorer autorisé. Le ReportExportRequest existant est réutilisé sans modification : une page demandée de 200 lignes au maximum ou un agrégat limité à 30 groupes au maximum, jamais un jeu de données complet ni un instantané transactionnel. Les unités brutes, devises, limites de format et restrictions de caractères PDF existantes restent applicables. Aucune opération financière, aucun email ni partage public n’est créé. Le pilote expire à l’échéance de sa source, au plus 600 secondes après la création ; le plafond général de 7 jours après la fin ne prolonge pas cette durée plus courte. Les lectures, répétitions et reconnexions ne renouvellent jamais l’expiration. Aucune étape de confirmation Unisoft supplémentaire ; l’hôte IA gère ses propres approbations d’écriture.

Exige reports:write en plus de statistics:read et un objet JSON vide. La répétition est idempotente. L’annulation peut arrêter un travail en attente ; pour une tâche en cours, elle enregistre seulement une demande et ne peut pas défaire un travail déjà admis. Consulter l’état obtenu au lieu de supposer que l’annulation a abouti. Les résultats terminaux restent terminaux.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "taskId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "UUID de tâche privée renvoyé par start_report_export_task."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "État de la tâche privée durable et métadonnées éventuelles de l’artefact figé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Paramètre de requête invalide ou inconnu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

```json
{
  "description": "Identité actuelle ou permissions requises refusées.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Tâche privée ou source autorisée indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit d’idempotence, verrou d’exécution conservé ou artefact pas encore disponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 410

```json
{
  "description": "Tâche ou source expirée ; aucun renouvellement n’est effectué.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Champs sources, format, intégrité du fichier ou limite de sortie refusés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 429

```json
{
  "description": "Quota actuel de tâches privées atteint ; consulter les tâches existantes avant de démarrer un autre export.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Pilote de tâches désactivé, stockage indisponible ou accusé de réception de commande incertain ; consulter la même tâche avant de résoudre l’incertitude.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

### OpenAPI

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

## GET /ai-tasks/{taskId}/artifact

Télécharger l’artefact figé d’une tâche privée

`download_unisoft_task_artifact`

Pilote de tâches durables d’export de rapports activé explicitement. Les installations où il est désactivé renvoient 503 MCP_TASKS_DISABLED sans appeler le moteur de tâches ni la source du rapport. Chaque tâche appartient exclusivement à la clé API d’organisation authentifiée ; les identifiants root, système ou limités à certaines campagnes sont refusés. Les identifiants actuels, l’organisation et toutes les permissions des sources sont revérifiés avant chaque divulgation ou commande. Exige statistics:read ainsi que les permissions des jeux de données et relations sources : contacts/interactions=contacts:read, paiements=paiements:read, abonnements=abonnements:read, promesses=promesses:read, forms_submit=forms:read AND forms_submit:read, cerfas=receipts:read. forms_submit exige aussi l’UUID d’un formulaire actuel non supprimé de la même organisation. Utiliser le catalogue Explorer autorisé. Le ReportExportRequest existant est réutilisé sans modification : une page demandée de 200 lignes au maximum ou un agrégat limité à 30 groupes au maximum, jamais un jeu de données complet ni un instantané transactionnel. Les unités brutes, devises, limites de format et restrictions de caractères PDF existantes restent applicables. Aucune opération financière, aucun email ni partage public n’est créé. Le pilote expire à l’échéance de sa source, au plus 600 secondes après la création ; le plafond général de 7 jours après la fin ne prolonge pas cette durée plus courte. Les lectures, répétitions et reconnexions ne renouvellent jamais l’expiration. Aucune étape de confirmation Unisoft supplémentaire ; l’hôte IA gère ses propres approbations d’écriture.

Télécharger uniquement les octets déjà figés de la source d’une tâche COMPLETED, avec le type MIME et le nom de fichier sûr de la pièce jointe. Cette opération réservée à REST n’exécute ni ne génère jamais un export. Vérifier byteLength et sha256 par rapport aux métadonnées de la tâche. Aucune URL de téléchargement externe ou publique n’est créée ; unisoft://tasks/{taskId}/artifact identifie la ressource MCP authentifiée correspondante.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "taskId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "UUID de tâche privée renvoyé par start_report_export_task."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Octets figés de l’export privé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "string",
        "format": "binary"
      }
    },
    "text/csv": {
      "schema": {
        "type": "string",
        "format": "binary"
      }
    },
    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
      "schema": {
        "type": "string",
        "format": "binary"
      }
    },
    "application/pdf": {
      "schema": {
        "type": "string",
        "format": "binary"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Paramètre de requête invalide ou inconnu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

```json
{
  "description": "Identité actuelle ou permissions requises refusées.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Tâche privée ou source autorisée indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit d’idempotence, verrou d’exécution conservé ou artefact pas encore disponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 410

```json
{
  "description": "Tâche ou source expirée ; aucun renouvellement n’est effectué.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Champs sources, format, intégrité du fichier ou limite de sortie refusés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 429

```json
{
  "description": "Quota actuel de tâches privées atteint ; consulter les tâches existantes avant de démarrer un autre export.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Pilote de tâches désactivé, stockage indisponible ou accusé de réception de commande incertain ; consulter la même tâche avant de résoudre l’incertitude.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftTaskError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "statistics:read",
  "x-unisoft-additional-scopes": [],
  "x-unisoft-conditional-scopes": [
    "contacts:read",
    "paiements:read",
    "abonnements:read",
    "promesses:read",
    "forms:read",
    "forms_submit:read",
    "receipts:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": 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
      },
      "UnisoftTaskResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/UnisoftTask"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "UnisoftTask": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "state": {
            "type": "string",
            "enum": [
              "QUEUED",
              "RUNNING",
              "COMPLETED",
              "CANCELLED",
              "FAILED"
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          },
          "finishedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "cancelRequested": {
            "type": "boolean"
          },
          "sourceJobId": {
            "type": "string",
            "format": "uuid"
          },
          "code": {
            "type": "string",
            "pattern": "^[A-Z][A-Z0-9_]{0,127}$",
            "nullable": true
          },
          "artifact": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/UnisoftTaskArtifact"
              },
              {
                "type": "object",
                "additionalProperties": false,
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ]
          }
        },
        "required": [
          "id",
          "state",
          "createdAt",
          "updatedAt",
          "expiresAt",
          "finishedAt",
          "cancelRequested",
          "sourceJobId",
          "code",
          "artifact"
        ]
      },
      "UnisoftTaskArtifact": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "uri": {
            "type": "string",
            "pattern": "^unisoft://tasks/[a-fA-F0-9-]{36}/artifact$"
          },
          "mimeType": {
            "type": "string",
            "enum": [
              "application/json",
              "text/csv",
              "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
              "application/pdf"
            ]
          },
          "fileName": {
            "type": "string",
            "enum": [
              "unisoft-report.json",
              "unisoft-report.csv",
              "unisoft-report.xlsx",
              "unisoft-report.pdf"
            ]
          },
          "sha256": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "byteLength": {
            "type": "integer",
            "minimum": 0,
            "maximum": 4194304
          }
        },
        "required": [
          "uri",
          "mimeType",
          "fileName",
          "sha256",
          "byteLength"
        ]
      },
      "UnisoftTaskError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
          },
          "required": {
            "type": "array",
            "maxItems": 16,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "maxLength": 128
            }
          },
          "details": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string",
                "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
              },
              "location": {
                "type": "string",
                "enum": [
                  "body",
                  "path",
                  "query"
                ]
              }
            },
            "required": [
              "code"
            ]
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
