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

# Mettre à jour un monitor



## OpenAPI

````yaml fr/api-reference/v2-openapi.json PATCH /monitor/{monitorId}
openapi: 3.0.0
info:
  contact:
    email: support@firecrawl.dev
    name: Firecrawl Support
    url: https://firecrawl.dev/support
  description: >-
    API pour interagir avec les services Firecrawl afin d’effectuer des tâches
    de scraping et de crawling web.
  title: Firecrawl API
  version: v2
servers:
  - url: https://api.firecrawl.dev/v2
security:
  - bearerAuth: []
paths:
  /monitor/{monitorId}:
    patch:
      tags:
        - Monitoring
      summary: Mettre à jour un monitor
      operationId: updateMonitor
      parameters:
        - $ref: '#/components/parameters/MonitorId'
      requestBody:
        content:
          application/json:
            example:
              schedule:
                text: every 15 minutes starting at :07
              status: active
            schema:
              $ref: '#/components/schemas/MonitorUpdateRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MonitorResponse'
          description: Monitor mis à jour
        '404':
          description: Monitor introuvable
      security:
        - bearerAuth: []
components:
  parameters:
    MonitorId:
      description: L’ID du monitor
      in: path
      name: monitorId
      required: true
      schema:
        format: uuid
        type: string
  schemas:
    MonitorUpdateRequest:
      description: Payload de mise à jour partielle du monitor. Incluez au moins un champ.
      properties:
        goal:
          description: >-
            Objectif en langage naturel utilisé pour évaluer si les pages
            modifiées sont pertinentes. S’il est fourni et que `judgeEnabled`
            est omis, l’évaluation est activée automatiquement. Obligatoire (non
            vide) lorsqu’une cible est de type `search`, sauf si `judgeEnabled`
            est `false`.
          maxLength: 2000
          nullable: true
          type: string
        judgeEnabled:
          description: >-
            Indique si les pages modifiées doivent être évaluées par rapport à
            `goal`. Nécessite un `goal` non vide pour s’exécuter.
          type: boolean
        name:
          maxLength: 256
          type: string
        notification:
          $ref: '#/components/schemas/MonitorNotification'
        retentionDays:
          maximum: 365
          minimum: 1
          type: integer
        schedule:
          $ref: '#/components/schemas/MonitorSchedule'
        status:
          enum:
            - active
            - paused
          type: string
        targets:
          items:
            $ref: '#/components/schemas/MonitorTarget'
          maxItems: 50
          minItems: 1
          type: array
        webhook:
          $ref: '#/components/schemas/MonitorWebhook'
      type: object
    MonitorResponse:
      properties:
        data:
          $ref: '#/components/schemas/Monitor'
        success:
          type: boolean
      type: object
    MonitorNotification:
      properties:
        email:
          properties:
            enabled:
              default: false
              type: boolean
            includeDiffs:
              default: false
              description: >-
                Inclure les détails des pages modifiées dans les résumés par
                e-mail.
              type: boolean
            recipients:
              items:
                format: email
                type: string
              maxItems: 25
              type: array
          type: object
      type: object
    MonitorSchedule:
      description: >-
        Planification des vérifications du monitor. Fournissez soit `cron`, soit
        `text`.
      properties:
        cron:
          description: >-
            Expression cron à cinq champs. L’intervalle minimal est de 5
            minutes.
          example: '*/30 * * * *'
          type: string
        text:
          description: >-
            Planification en langage naturel. Les exemples pris en charge
            incluent `toutes les 30 minutes`, `toutes les 15 minutes à partir de
            :07`, `toutes les heures`, `toutes les 2 heures`, `tous les jours`,
            `tous les jours à 9:00`, `tous les jours à 9 h`, `tous les jours à
            17:30` et `toutes les semaines`.
          example: every 30 minutes
          type: string
        timezone:
          default: UTC
          description: Fuseau horaire IANA pour la planification.
          example: UTC
          type: string
      type: object
    MonitorTarget:
      oneOf:
        - properties:
            id:
              description: ID stable facultatif pour cette cible. Généré s’il est omis.
              format: uuid
              type: string
            scrapeOptions:
              $ref: '#/components/schemas/ScrapeOptions'
            type:
              enum:
                - scrape
              type: string
            urls:
              items:
                format: uri
                type: string
              minItems: 1
              type: array
          required:
            - type
            - urls
          title: Scrape target
          type: object
        - properties:
            crawlOptions:
              description: >-
                Options de crawl telles que `limit`, `maxDepth`, `includePaths`
                et `excludePaths`.
              type: object
            id:
              description: ID stable facultatif pour cette cible. Généré s’il est omis.
              format: uuid
              type: string
            scrapeOptions:
              $ref: '#/components/schemas/ScrapeOptions'
            type:
              enum:
                - crawl
              type: string
            url:
              format: uri
              type: string
          required:
            - type
            - url
          title: Crawl target
          type: object
        - description: >-
            Exécute des requêtes de recherche web à chaque vérification et
            envoie des alertes pour les nouveaux résultats correspondant à
            l’objectif du monitor. Nécessite un `goal` de premier niveau non
            vide sur le monitor, sauf si `judgeEnabled` est `false`.
          properties:
            excludeDomains:
              description: Facultatif. Exclure les résultats provenant de ces domaines.
              items:
                type: string
              maxItems: 50
              type: array
            id:
              description: ID stable facultatif pour cette cible. Généré s’il est omis.
              format: uuid
              type: string
            includeDomains:
              description: Facultatif. Limiter les résultats à ces domaines.
              items:
                type: string
              maxItems: 50
              type: array
            maxResults:
              default: 10
              description: >-
                Nombre total de résultats à évaluer par vérification, fusionnés
                et dédupliqués sur l’ensemble des requêtes (plafond global, et
                non par requête).
              maximum: 50
              minimum: 1
              type: integer
            queries:
              description: Requêtes de recherche à exécuter à chaque vérification (1 à 12).
              items:
                maxLength: 256
                minLength: 1
                type: string
              maxItems: 12
              minItems: 1
              type: array
            searchWindow:
              default: 24h
              description: >-
                Filtre de récence — prend uniquement en compte les résultats
                publiés dans cette période.
              enum:
                - 5m
                - 15m
                - 1h
                - 6h
                - 24h
                - 7d
              type: string
            type:
              enum:
                - search
              type: string
          required:
            - type
            - queries
          title: Search target
          type: object
    MonitorWebhook:
      description: >-
        Destination du webhook pour les événements de page du monitor et de fin
        de vérification.
      properties:
        events:
          description: >-
            Événements webhook du monitor à recevoir. Par défaut, tous les
            événements du monitor sont reçus.
          items:
            enum:
              - monitor.page
              - monitor.check.completed
            type: string
          type: array
        headers:
          additionalProperties:
            type: string
          description: En-têtes à envoyer à l’URL du webhook.
          type: object
        metadata:
          additionalProperties: true
          description: Métadonnées personnalisées incluses dans les payloads des webhooks.
          type: object
        url:
          description: URL à laquelle envoyer les webhooks du monitor.
          format: uri
          type: string
      required:
        - url
      type: object
    Monitor:
      properties:
        createdAt:
          format: date-time
          type: string
        currentCheckId:
          format: uuid
          nullable: true
          type: string
        estimatedCreditsPerMonth:
          description: >-
            Estimation mensuelle maximale des crédits. Lorsque l’évaluation est
            activée, l’usage réel peut être inférieur, car les crédits
            d’évaluation ne sont facturés que pour les pages modifiées qui sont
            évaluées.
          nullable: true
          type: integer
        goal:
          nullable: true
          type: string
        id:
          format: uuid
          type: string
        judgeEnabled:
          type: boolean
        lastCheckSummary:
          $ref: '#/components/schemas/MonitorSummary'
        lastRunAt:
          format: date-time
          nullable: true
          type: string
        name:
          type: string
        nextRunAt:
          format: date-time
          nullable: true
          type: string
        notification:
          $ref: '#/components/schemas/MonitorNotification'
        retentionDays:
          type: integer
        schedule:
          properties:
            cron:
              type: string
            timezone:
              type: string
          type: object
        status:
          enum:
            - active
            - paused
            - deleted
          type: string
        targets:
          items:
            $ref: '#/components/schemas/MonitorTarget'
          type: array
        updatedAt:
          format: date-time
          type: string
        webhook:
          $ref: '#/components/schemas/MonitorWebhook'
      type: object
    ScrapeOptions:
      properties:
        actions:
          description: Actions à effectuer sur la page avant de récupérer le contenu
          items:
            oneOf:
              - oneOf:
                  - additionalProperties: false
                    properties:
                      milliseconds:
                        description: Nombre de millisecondes à attendre
                        minimum: 1
                        type: integer
                      type:
                        description: Attendre un nombre spécifié de millisecondes
                        enum:
                          - wait
                        type: string
                    required:
                      - type
                      - milliseconds
                    title: Wait by Duration
                    type: object
                  - additionalProperties: false
                    properties:
                      selector:
                        description: Sélecteur CSS à surveiller
                        example: '#my-element'
                        type: string
                      type:
                        description: Attendre l’apparition d’un élément spécifique
                        enum:
                          - wait
                        type: string
                    required:
                      - type
                      - selector
                    title: Wait for Element
                    type: object
                title: Wait
              - properties:
                  fullPage:
                    default: false
                    description: >-
                      Indique s’il faut prendre une capture d’écran de la page
                      entière (en ignorant viewport.height) ou seulement de la
                      zone actuellement visible (viewport).
                    type: boolean
                  quality:
                    description: >-
                      Qualité de la capture d’écran, de 1 à 100, 100 étant la
                      meilleure qualité.
                    type: integer
                  type:
                    description: >-
                      Prenez une capture d’écran. Les liens se trouveront dans
                      le tableau `actions.screenshots` de la réponse.
                    enum:
                      - screenshot
                    type: string
                  viewport:
                    properties:
                      height:
                        description: Hauteur du viewport en pixels
                        type: integer
                      width:
                        description: La largeur de la fenêtre d’affichage, en pixels
                        type: integer
                    required:
                      - width
                      - height
                    type: object
                required:
                  - type
                title: Screenshot
                type: object
              - properties:
                  all:
                    default: false
                    description: >-
                      Clique sur tous les éléments correspondant au sélecteur,
                      et pas seulement sur le premier. Ne lève pas d’erreur si
                      aucun élément ne correspond au sélecteur.
                    type: boolean
                  selector:
                    description: Sélecteur pour trouver l’élément par
                    example: '#load-more-button'
                    type: string
                  type:
                    description: Cliquez sur un élément
                    enum:
                      - click
                    type: string
                required:
                  - type
                  - selector
                title: Click
                type: object
              - properties:
                  text:
                    description: Texte à saisir
                    example: Hello, world!
                    type: string
                  type:
                    description: >-
                      Écrivez du texte dans un champ de saisie, une zone de
                      texte ou un élément contenteditable. Remarque : vous devez
                      d’abord placer le focus sur l’élément à l’aide d’une
                      action « click » avant d’écrire. Le texte sera saisi
                      caractère par caractère pour simuler une saisie au
                      clavier.
                    enum:
                      - write
                    type: string
                required:
                  - type
                  - text
                title: Write text
                type: object
              - description: >-
                  Appuyez sur une touche du clavier. Reportez-vous à
                  https://asawicki.info/nosense/doc/devices/keyboard/key_codes.html
                  pour la liste des codes de touches.
                properties:
                  key:
                    description: Touche sur laquelle appuyer
                    example: Enter
                    type: string
                  type:
                    description: Appuyez sur une touche de la page
                    enum:
                      - press
                    type: string
                required:
                  - type
                  - key
                title: Press a key
                type: object
              - properties:
                  direction:
                    default: down
                    description: Sens de défilement
                    enum:
                      - up
                      - down
                    type: string
                  selector:
                    description: Sélecteur CSS de l’élément à faire défiler
                    example: '#my-element'
                    type: string
                  type:
                    description: Faites défiler la page ou un élément spécifique
                    enum:
                      - scroll
                    type: string
                required:
                  - type
                title: Scroll
                type: object
              - properties:
                  type:
                    description: >-
                      Extrait le contenu de la page actuelle et renvoie l’URL et
                      le HTML.
                    enum:
                      - scrape
                    type: string
                required:
                  - type
                title: Scrape
                type: object
              - properties:
                  script:
                    description: Code JavaScript à exécuter
                    example: document.querySelector('.button').click();
                    type: string
                  type:
                    description: Exécuter du code JavaScript sur la page
                    enum:
                      - executeJavascript
                    type: string
                required:
                  - type
                  - script
                title: Execute JavaScript
                type: object
              - properties:
                  format:
                    default: Letter
                    description: Le format de page du PDF obtenu
                    enum:
                      - A0
                      - A1
                      - A2
                      - A3
                      - A4
                      - A5
                      - A6
                      - Letter
                      - Legal
                      - Tabloid
                      - Ledger
                    type: string
                  landscape:
                    default: false
                    description: Détermine s’il faut générer le PDF au format paysage
                    type: boolean
                  scale:
                    default: 1
                    description: Facteur d’échelle du PDF généré
                    type: number
                  type:
                    description: >-
                      Génère un PDF de la page en cours. Le PDF sera renvoyé
                      dans le tableau `actions.pdfs` de la réponse.
                    enum:
                      - pdf
                    type: string
                required:
                  - type
                title: Generate PDF
                type: object
          type: array
        blockAds:
          default: true
          description: >-
            Active le blocage des publicités et des fenêtres contextuelles de
            cookies.
          type: boolean
        excludeTags:
          description: Balises à exclure du résultat.
          items:
            type: string
          type: array
        formats:
          $ref: '#/components/schemas/Formats'
        headers:
          description: >-
            En-têtes à inclure dans la requête. Peuvent être utilisés pour
            envoyer des cookies, un user-agent, etc.
          type: object
        includeTags:
          description: Balises à inclure dans le résultat.
          items:
            type: string
          type: array
        location:
          description: >-
            Paramètres de localisation pour la requête. Lorsqu’ils sont définis,
            un proxy approprié sera utilisé si disponible et les paramètres de
            langue et de fuseau horaire correspondants seront simulés. La valeur
            par défaut est « US » si aucun n’est spécifié.
          properties:
            country:
              default: US
              description: >-
                Code de pays ISO 3166-1 alpha-2 (p. ex. « US », « AU », « DE »,
                « JP »)
              pattern: ^[A-Z]{2}$
              type: string
            languages:
              description: >-
                Langues et paramètres régionaux préférés pour la requête, par
                ordre de priorité. Utilise par défaut la langue de l’emplacement
                spécifié. Voir
                https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language
              items:
                example: en-US
                type: string
              type: array
          type: object
        lockdown:
          default: false
          description: >-
            Si défini sur true, la requête est traitée uniquement à partir du
            cache de Firecrawl et n’effectue jamais de requête sortante vers
            l’URL cible. Conçu pour les environnements soumis à des contraintes
            de conformité ou isolés du réseau, où la requête de scrape elle-même
            pourrait divulguer des informations sensibles. En cas d’absence dans
            le cache, renvoie une 404 avec le code d’erreur
            SCRAPE_LOCKDOWN_CACHE_MISS (l’URL n’est jamais journalisée en cas
            d’absence dans le cache). Les requêtes Lockdown sont traitées en
            mode zero data retention. La valeur maxAge par défaut est portée à 2
            ans afin que les pages déjà mises en cache restent éligibles.
            Facturé 5 crédits en cas de hit, 1 crédit en cas d’absence dans le
            cache.
          type: boolean
        maxAge:
          default: 172800000
          description: "Retourne une version mise en cache de la page si elle est plus récente que cette durée (en millisecondes). Si une version mise en cache de la page est plus ancienne que cette valeur, la page sera à nouveau explorée (scrapée). Si vous n’avez pas besoin de données extrêmement récentes, activer cette option peut accélérer vos opérations de scraping de 500 %. Par défaut\_: 2\_jours."
          type: integer
        minAge:
          description: >-
            Lorsqu’elle est définie, la requête vérifie uniquement le cache et
            ne déclenche jamais une nouvelle opération de scraping. La valeur
            est exprimée en millisecondes et indique l’âge minimal que doivent
            avoir les données en cache. Si des données en cache correspondantes
            existent, elles sont renvoyées instantanément. Si aucune donnée en
            cache n’est trouvée, une réponse 404 avec le code d’erreur
            SCRAPE_NO_CACHED_DATA est renvoyée. Définissez-la sur 1 pour
            accepter n’importe quelle donnée en cache, quel que soit son âge.
          type: integer
        mobile:
          default: false
          description: >-
            Définissez cette option sur true pour simuler le scraping depuis un
            appareil mobile. Utile pour tester des pages responsives et prendre
            des captures d’écran en mode mobile.
          type: boolean
        onlyCleanContent:
          default: false
          description: >-
            Bêta. Exécute un passage supplémentaire basé sur un LLM sur le
            markdown généré afin de supprimer les éléments parasites résiduels
            que `onlyMainContent` peut manquer (bannières de cookies, blocs
            publicitaires, widgets de partage sur les réseaux sociaux, fils
            d’Ariane, inscriptions à la newsletter, sections de commentaires,
            listes d’articles similaires). Les titres, listes, tableaux, blocs
            de code, références d’images et liens intégrés sont conservés. Peut
            être combiné avec `onlyMainContent` (la configuration la plus
            courante) ou utilisé seul. Ignoré avec un avertissement lorsque le
            markdown dépasse la limite de jetons de sortie du modèle de
            nettoyage (le markdown d’origine est conservé). Non pris en charge
            pour les requêtes sans conservation des données.
          type: boolean
        onlyMainContent:
          default: true
          description: >-
            Retourne uniquement le contenu principal de la page, à l’exclusion
            des en-têtes, menus de navigation, pieds de page, etc. Il s’agit
            d’un filtre déterministe appliqué au niveau HTML avant la génération
            du markdown ; aucun LLM n’intervient.
          type: boolean
        parsers:
          default:
            - pdf
          description: >-
            Contrôle la façon dont les fichiers sont traités lors du scraping.
            Lorsque « pdf » est inclus (valeur par défaut), le contenu du PDF
            est extrait et converti au format Markdown, avec une facturation
            basée sur le nombre de pages (1 crédit par page). Lorsqu’un tableau
            vide est envoyé, le fichier PDF est renvoyé en encodage base64 avec
            un tarif fixe de 1 crédit pour l’ensemble du PDF.
          items:
            oneOf:
              - additionalProperties: false
                properties:
                  maxPages:
                    description: >-
                      Nombre maximal de pages du PDF à analyser. Doit être un
                      entier positif inférieur ou égal à 10 000.
                    maximum: 10000
                    minimum: 1
                    type: integer
                  mode:
                    default: auto
                    description: >-
                      Mode d’analyse des PDF. « fast » : extraction basée
                      uniquement sur le texte (texte intégré, la plus rapide). «
                      auto » (par défaut) : tente d’abord une extraction rapide,
                      puis bascule vers l’OCR si nécessaire. « ocr » : impose
                      une analyse OCR (reconnaissance optique de caractères) sur
                      chaque page.
                    enum:
                      - fast
                      - auto
                      - ocr
                    type: string
                  type:
                    enum:
                      - pdf
                    type: string
                required:
                  - type
                type: object
          type: array
        profile:
          description: >-
            Active le stockage persistant du navigateur entre les sessions de
            scrape et d’Interact. Transmettez un profil lors du scraping pour
            conserver les cookies, le localStorage et les données de session.
            Les sessions portant le même nom de profil partagent l’état du
            navigateur.
          properties:
            name:
              description: >-
                Nom du profil. Les scrapes portant le même nom partagent l’état
                du navigateur (cookies, localStorage, sessions).
              maxLength: 128
              minLength: 1
              type: string
            saveChanges:
              default: true
              description: >-
                Si la valeur est true, l’état du navigateur est enregistré dans
                le profil lorsque la session Interact s’arrête. Définissez la
                valeur sur false pour charger les données existantes sans les
                écrire. Une seule session d’enregistrement est autorisée à la
                fois.
              type: boolean
          required:
            - name
          type: object
        proxy:
          default: auto
          description: "Spécifie le type de proxy à utiliser.\n\n - **basic**\_: Proxies pour le scraping de sites avec des solutions anti‑bots inexistantes ou basiques. Rapides et généralement efficaces.\n - **enhanced**\_: Proxies renforcés pour le scraping de sites avec des solutions anti‑bots avancées. Plus lents, mais plus fiables sur certains sites. Peut coûter jusqu’à 5 crédits par requête.\n - **auto**\_: Firecrawl réessaiera automatiquement le scraping avec des proxies renforcés si le proxy basic échoue. Si la nouvelle tentative avec le proxy renforcé réussit, 5 crédits seront facturés pour l’opération de scraping. Si la première tentative avec le proxy basic réussit, seul le coût standard sera facturé."
          enum:
            - basic
            - enhanced
            - auto
          type: string
        redactPII:
          default: false
          description: >-
            Masquez les données personnelles identifiables dans le markdown
            renvoyé. Passez `true` pour utiliser les valeurs par défaut, ou un
            objet pour ajuster le mode, les entités et le style de remplacement.
          oneOf:
            - type: boolean
            - $ref: '#/components/schemas/RedactPIIOptions'
        removeBase64Images:
          default: true
          description: |-
            <[
              {
                "key": "0",
                "translation": "Supprime toutes les images encodées en base64 de la sortie markdown, qui peut devenir excessivement longue. Cela n’affecte pas les formats html ou rawHtml. Le texte alternatif de l’image reste dans la sortie, mais l’URL est remplacée par un espace réservé."
              }
            ]</>
          type: boolean
        skipTlsVerification:
          default: true
          description: Ignorer la vérification du certificat TLS lors des requêtes.
          type: boolean
        storeInCache:
          default: true
          description: >-
            Si ce paramètre est défini sur true, la page sera stockée dans
            l’index et le cache de Firecrawl. Le définir sur false est utile si
            votre activité de scraping peut soulever des problèmes de protection
            des données. L’utilisation de certains paramètres associés à un
            scraping sensible (par ex. actions, headers) forcera ce paramètre à
            false.
          type: boolean
        threatProtection:
          $ref: '#/components/schemas/ThreatProtectionOverride'
        timeout:
          default: 60000
          description: >-
            Délai d’expiration de la requête en millisecondes. La valeur
            minimale est de 1000 (1 seconde). La valeur par défaut est de 60000
            (60 secondes). La valeur maximale est de 300000 (300 secondes).
          maximum: 300000
          minimum: 1000
          type: integer
        waitFor:
          default: 0
          description: >-
            Indiquez un délai en millisecondes avant de récupérer le contenu,
            afin de laisser à la page suffisamment de temps pour se charger. Ce
            temps d’attente s’ajoute à la fonction d’attente intelligente de
            Firecrawl.
          type: integer
      type: object
    MonitorSummary:
      properties:
        changed:
          type: integer
        error:
          type: integer
        new:
          type: integer
        removed:
          type: integer
        same:
          type: integer
        totalPages:
          type: integer
      type: object
    Formats:
      default:
        - markdown
      description: >-
        Formats de sortie à inclure dans la réponse. Vous pouvez spécifier un ou
        plusieurs formats, soit sous forme de chaînes (par ex. `'markdown'`),
        soit sous forme d’objets avec des options supplémentaires (par ex. `{
        type: 'json', schema: {...} }`). Certains formats requièrent la
        définition d’options spécifiques. Exemple : `['markdown', { type:
        'json', schema: {...} }]`.
      items:
        oneOf:
          - properties:
              type:
                enum:
                  - markdown
                type: string
            required:
              - type
            title: Markdown
            type: object
          - properties:
              type:
                enum:
                  - summary
                type: string
            required:
              - type
            title: Summary
            type: object
          - properties:
              type:
                enum:
                  - html
                type: string
            required:
              - type
            title: HTML
            type: object
          - properties:
              type:
                enum:
                  - rawHtml
                type: string
            required:
              - type
            title: Raw HTML
            type: object
          - properties:
              type:
                enum:
                  - links
                type: string
            required:
              - type
            title: Links
            type: object
          - properties:
              type:
                enum:
                  - images
                type: string
            required:
              - type
            title: Images
            type: object
          - properties:
              fullPage:
                default: false
                description: >-
                  Indique s’il faut prendre une capture d’écran de la page
                  entière (en ignorant viewport.height) ou seulement de la zone
                  actuellement visible (viewport).
                type: boolean
              quality:
                description: >-
                  La qualité de la capture d’écran, sur une échelle de 1 à 100.
                  100 correspond à la qualité maximale.
                type: integer
              type:
                enum:
                  - screenshot
                type: string
              viewport:
                properties:
                  height:
                    description: La hauteur du viewport en pixels
                    type: integer
                  width:
                    description: Largeur du viewport en pixels
                    type: integer
                required:
                  - width
                  - height
                type: object
            required:
              - type
            title: Screenshot
            type: object
          - properties:
              prompt:
                description: L’invite à utiliser pour la sortie au format JSON
                type: string
              schema:
                description: >-
                  Le schéma à utiliser pour la sortie JSON. Doit être conforme à
                  [JSON Schema](https://json-schema.org/).
                type: object
              type:
                enum:
                  - json
                type: string
            required:
              - type
            title: JSON
            type: object
          - properties:
              modes:
                description: >-
                  Le mode de suivi des modifications à utiliser. « git-diff »
                  fournit un diff détaillé, tandis que « json » compare les
                  données JSON extraites.
                items:
                  enum:
                    - git-diff
                    - json
                  type: string
                type: array
              prompt:
                description: >-
                  Invite (prompt) à utiliser pour le suivi des modifications en
                  mode « json ». S’il n’est pas fourni, l’invite (prompt) par
                  défaut sera utilisée.
                type: string
              schema:
                description: >-
                  Schéma JSON pour l’extraction en mode « json ». Définit la
                  structure des données à extraire et à comparer. Doit être
                  conforme à [JSON Schema](https://json-schema.org/).
                type: object
              tag:
                default: null
                description: >-
                  Tag à utiliser pour le suivi des modifications. Les tags
                  peuvent séparer l’historique du suivi des modifications en «
                  branches » distinctes, où le suivi avec un tag spécifique ne
                  sera comparé qu’aux extractions effectuées avec ce même tag.
                  S’il n’est pas fourni, le tag par défaut (null) sera utilisé.
                nullable: true
                type: string
              type:
                enum:
                  - changeTracking
                type: string
            required:
              - type
            title: Change Tracking
            type: object
          - properties:
              type:
                enum:
                  - branding
                type: string
            required:
              - type
            title: Branding
            type: object
          - properties:
              type:
                enum:
                  - product
                type: string
            required:
              - type
            title: Product
            type: object
          - properties:
              type:
                enum:
                  - menu
                type: string
            required:
              - type
            title: Menu
            type: object
          - description: >-
              Extrait l’audio (MP3) depuis des URL vidéo prises en charge, par
              ex. YouTube. Renvoie une URL GCS signée.
            properties:
              type:
                enum:
                  - audio
                type: string
            required:
              - type
            title: Audio
            type: object
          - description: >-
              Extrait la vidéo dans la meilleure qualité depuis des URL vidéo
              prises en charge, par ex. YouTube. Renvoie une URL GCS signée.
            properties:
              type:
                enum:
                  - video
                type: string
            required:
              - type
            title: Video
            type: object
          - description: >-
              Pose une question en langage naturel sur la page. Renvoie la
              réponse dans le champ `answer` de la réponse.
            properties:
              question:
                description: >-
                  La question à laquelle répondre sur la page. Maximum 10 000
                  caractères.
                maxLength: 10000
                type: string
              type:
                enum:
                  - question
                type: string
            required:
              - type
              - question
            title: Question
            type: object
          - description: >-
              Trouve le texte source pertinent sur la page. Renvoie le texte
              sélectionné dans le champ `highlights` de la réponse.
            properties:
              query:
                description: >-
                  La requête de sélection de texte à exécuter sur la page.
                  Maximum 10 000 caractères.
                maxLength: 10000
                type: string
              type:
                enum:
                  - highlights
                type: string
            required:
              - type
              - query
            title: Highlights
            type: object
      type: array
    RedactPIIOptions:
      additionalProperties: false
      description: Options de réglage du masquage des PII.
      properties:
        entities:
          description: >-
            Limitez le masquage à ces groupes d'entités. Si ce champ est omis,
            toutes les entités prises en charge sont masquées.
          items:
            $ref: '#/components/schemas/RedactPIIEntity'
          type: array
        mode:
          default: accurate
          description: >-
            Stratégie de masquage. `accurate` utilise uniquement le modèle et
            est optimisée pour la précision, `aggressive` augmente le rappel
            grâce à des heuristiques supplémentaires, et `fast` utilise des
            heuristiques sans appel au modèle.
          enum:
            - accurate
            - aggressive
            - fast
          type: string
        replaceStyle:
          default: tag
          description: >-
            `tag` remplace les portions de texte par des marqueurs comme
            `<EMAIL>`, `mask` remplace les caractères par `*`, et `remove`
            supprime le texte de la portion.
          enum:
            - tag
            - mask
            - remove
          type: string
      type: object
    ThreatProtectionOverride:
      description: >-
        Dérogation [Protection contre les
        menaces](https://docs.firecrawl.dev/features/threat-protection) au
        niveau de la requête. Les champs que vous fournissez remplacent les
        champs correspondants de la politique de votre organisation pour cette
        requête uniquement ; les champs omis conservent leurs valeurs définies
        au niveau de l'organisation. La Protection contre les menaces doit être
        activée pour votre équipe (fonctionnalité Enterprise) ; sinon, la
        requête est rejetée avec un code 403. Si votre organisation a désactivé
        les dérogations par requête, toute requête qui inclut cet objet est
        rejetée avec un code 403. Si la Protection contre les menaces est
        appliquée à votre équipe, `mode` ne peut pas être défini sur `off`.
      properties:
        blacklist:
          description: >-
            Domaines à toujours bloquer, sous forme de domaines simples
            (`example.com`) ou de motifs avec joker (`*.example.com`). Sans
            protocole, chemin ni port.
          items:
            type: string
          maxItems: 1000
          type: array
        blockedTlds:
          description: >-
            Domaines de premier niveau à bloquer systématiquement, en minuscules
            et sans le point initial (par ex. `zip`).
          items:
            type: string
          maxItems: 1000
          type: array
        failurePolicy:
          description: >-
            Comportement à adopter lorsque le classifieur est injoignable :
            `closed` bloque la requête, `open` l'autorise.
          enum:
            - open
            - closed
          type: string
        mode:
          description: >-
            Mode d'analyse des domaines pour cette requête. `normal` vérifie les
            domaines par rapport à Google Web Risk (+2 crédits par domaine
            analysé).
          enum:
            - 'off'
            - normal
          type: string
        riskScoreThreshold:
          description: >-
            Score de risque normalisé (0–100) à partir duquel le verdict d'un
            classifieur bloque le domaine. Plus il est bas, plus la règle est
            stricte.
          example: 75
          maximum: 100
          minimum: 0
          type: integer
        whitelist:
          description: >-
            Domaines à toujours autoriser, sous forme de domaines simples ou de
            motifs avec joker. Prend le pas sur toutes les autres règles.
          items:
            type: string
          maxItems: 1000
          type: array
      title: Threat Protection Override
      type: object
    RedactPIIEntity:
      description: >-
        Groupes d'entités PII publiques pris en charge par le masquage de
        Firecrawl.
      enum:
        - PERSON
        - EMAIL
        - PHONE
        - LOCATION
        - FINANCIAL
        - SECRET
      type: string
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````