> ## Documentation Index > Fetch the complete documentation index at: https://developers.0flaw.fr/llms.txt > Use this file to discover all available pages before exploring further. # Créer ou mettre à jour un employé > Version unitaire de `/employees/sync`, pour un provisioning au fil de l'eau. ## OpenAPI ````yaml /openapi.json post /api/v1/employees openapi: 3.1.0 info: title: API 0flaw version: 1.0.0 description: >- API publique de 0flaw : provisionnez vos employés depuis votre SIRH/AD et recevez les événements de sécurité dans votre SIEM. ## Authentification Toutes les requêtes exigent une clé API, créée depuis votre dashboard (Réglages → Clés API). Transmettez-la dans l'en-tête `Authorization` : ``` Authorization: Bearer 0flaw_live_xxxxxxxx ``` L'en-tête `x-api-key` est également accepté. Une clé est **scopée à une seule entreprise** : elle ne peut jamais lire ni modifier les données d'une autre. ## Limites de débit 600 requêtes par tranche de 15 minutes et par clé. Les en-têtes `RateLimit-*` accompagnent chaque réponse ; un dépassement renvoie `429`. ## Gestion des erreurs Fiez-vous au champ `code` (stable) et non au `message` (susceptible d'évoluer). contact: name: Support 0flaw url: https://app.0flaw.fr servers: - url: https://api.0flaw.fr description: Production security: - apiKey: [] tags: - name: Général description: Vérification d'accès et introspection de la clé - name: Employés description: 'Provisioning : création, mise à jour, désactivation, invitations' - name: Résultats description: Campagnes de phishing et leurs résultats (scope read:results) - name: Radar description: Risk scores par axe (scope read:scores) - name: Formations description: Statut des formations des employés (scope read:trainings) paths: /api/v1/employees: post: tags: - Employés summary: Créer ou mettre à jour un employé description: >- Version unitaire de `/employees/sync`, pour un provisioning au fil de l'eau. requestBody: required: true content: application/json: schema: allOf: - $ref: '#/components/schemas/EmployeeRecord' - type: object properties: send_invitation: type: boolean default: false description: >- Envoyer immédiatement l'email d'accès (mot de passe temporaire) example: email: jane.doe@acme.com nom: Doe prenom: Jane external_id: hr-4821 responses: '200': description: Employé créé ou mis à jour content: application/json: schema: type: object properties: ok: type: boolean employee: $ref: '#/components/schemas/SyncResultItem' summary: $ref: '#/components/schemas/SyncSummary' '400': description: Corps de requête invalide content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: message: Email invalide code: VALIDATION_ERROR '401': description: Clé API absente ou invalide content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: message: Clé API invalide ou révoquée code: API_KEY_INVALID '403': description: La clé ne porte pas le scope requis content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: message: 'Scope requis : write:employees' code: INSUFFICIENT_SCOPE '429': description: Quota de requêtes dépassé pour cette clé content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: message: Trop de requêtes, réessayez plus tard. code: RATE_LIMIT_EXCEEDED security: - apiKey: - write:employees components: schemas: EmployeeRecord: type: object required: - email - nom - prenom properties: external_id: type: string maxLength: 191 description: >- Identifiant de l'employé dans VOTRE système. Clé de rapprochement prioritaire : la fournir permet de suivre un employé même si son email change. email: type: string format: email nom: type: string minLength: 1 maxLength: 100 prenom: type: string minLength: 1 maxLength: 100 fonction: type: string maxLength: 100 telephone: type: string maxLength: 30 adresse: type: string maxLength: 255 secteur: type: string maxLength: 150 description: Nom du secteur — créé automatiquement s'il n'existe pas secteur_id: oneOf: - type: string maxLength: 64 - type: integer description: Alternative à `secteur` active: type: boolean description: '`false` archive cet employé' SyncResultItem: type: object properties: external_id: type: - string - 'null' email: type: string action: type: string enum: - created - updated - reactivated - skipped - deactivated - failed id: type: string description: Identifiant 0flaw de l'employé error: type: string description: >- Présent si `action = failed`. Notamment `email_conflict_other_tenant` (l'email appartient à une autre entreprise) ou `duplicate_in_payload`. planned: type: boolean description: 'Présent en `dry_run` : action qui serait effectuée' SyncSummary: type: object properties: received: type: integer created: type: integer updated: type: integer reactivated: type: integer deactivated: type: integer skipped: type: integer description: 'Employés déjà à jour : aucune écriture' failed: type: integer ErrorResponse: type: object properties: message: type: string description: Message lisible par un humain code: type: string description: Code stable, à utiliser pour la logique client required: - message - code securitySchemes: apiKey: type: http scheme: bearer description: >- Clé API créée depuis le dashboard (Réglages → Clés API). L'en-tête `x-api-key: ` est accepté en alternative à `Authorization: Bearer `. ````