---
title: "Créer un agent de veille"
method: POST
path: "/veilles"
---

# Créer un agent de veille

`POST /veilles`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/veilles`
- Auth: HTTP bearer

Crée un agent de veille sur les annonces, rattaché au compte de la clé : à partir d'une mission en langage naturel, traduite en pré-filtre par un modèle de langage, ou de critères exacts (recherche), sans modèle. L'agent remonte chaque jour les nouvelles annonces qui collent, jugées contre la mission par le juge IA ; ses résultats se lisent par resultats_veilles. Le compte garde un plafond d'agents actifs. Un agent créé par l'API est rattaché à l'organisation de la clé et débité, tant qu'il est actif, de 1 crédit par jour (barème veille_jour). Exige une clé rattachée à un compte Pillr. Coût : 20 crédits par appel réussi ; 0 crédit par appel réussi avec des critères exacts (recherche).

## Request body

- object
  - `mission` string: Ce que l'agent surveille, en une phrase.
  - `recherche` object: Critères exacts, sans interprétation par un modèle.
    - `communes` string[]: Noms de communes (le moteur des veilles suit les communes par leur nom).
    - `cp` string[]
    - `departement` string[]
    - `autour` object: Un cercle autour d'un point ; il remplace les communes.
      - `lat` number, required
      - `lon` number, required
      - `rayon_km` number, required
    - `type` 'appartement' | 'maison' | 'immeuble'
    - `prix_min` number
    - `prix_max` number
    - `surface_min` number
    - `surface_max` number
    - `pieces_min` integer
    - `pieces_max` integer
    - `prix_m2_min` number
    - `prix_m2_max` number
    - `terrain_min` number
    - `terrain_max` number
    - `travaux_min` number
    - `travaux_max` number
    - `rendement_min` number: Rendement brut minimal, en %.
    - `rendement_net_min` number
    - `score_min` number
    - `dpe_max` 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G': Pire DPE accepté.
    - `exclure_residences_gerees` boolean
  - `nom` string
  - `frequence` 'immediate' | 'daily' | 'weekly': immediate, daily (défaut) ou weekly : cadence des notifications du compte.
  - `signaux` object: Les signaux suivis par l'agent.
    - `nouvelles` boolean: Nouvelles annonces qui correspondent (vrai par défaut).
    - `baisses` boolean: Baisses de prix des annonces qui correspondent (faux par défaut).
    - `negociation` boolean: Annonces dont la décote par rapport à la cible de négociation est forte (faux par défaut).
  - `actif` boolean: Faux : l'agent est créé en pause (vrai par défaut).

## Response `201`

Ressource créée.

- object
  - `veille` object, required
    - `id` string, required
    - `nom` string, nullable, required
    - `mission` string, nullable, required: Intention en langage naturel, lue chaque jour par le juge IA.
    - `actif` boolean, required
    - `frequence` string, nullable, required
    - `criteres` string[], required: Les critères enregistrés, en clair, relus sur la ligne enregistrée.
    - `dernier_jugement_ia` string, nullable, required
    - `biens_7j` integer, required: Biens remontés par l'agent sur les 7 derniers jours.
    - `cree_le` string, nullable, required
  - `non_repris` string[], required: Ce que le moteur des veilles ne filtre pas et que seul le juge IA lit dans la mission.
  - `vivier` integer, nullable, required: Annonces analysées qui collent déjà au pré-filtre ; null s'il n'a pas pu être compté.
  - `credits` object, required: Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
    - `debites` integer, required
    - `restants` integer, nullable, required

## Other responses

- `400`: Paramètres invalides
- `401`: Clé d'API absente
- `402`: Crédits insuffisants ; Carte requise ; Plafond mensuel de dépense atteint
- `403`: Portée insuffisante ; Clé sans compte rattaché
- `404`: Ressource absente : rien n'est débité
- `429`: Trop de requêtes par minute
- `500`: Erreur interne
- `503`: API indisponible

---

[API](https://skmtc.dev/pillr/apis/api-pillr.md) · [All operations](https://skmtc.dev/pillr/apis/api-pillr/llms.txt) · [OpenAPI document](https://skmtc.dev/pillr/apis/api-pillr/revisions/218b2866bd6c?raw)