---
title: "Modifier un agent de veille"
method: PATCH
path: "/veilles/{id}"
---

# Modifier un agent de veille

`PATCH /veilles/{id}`

## Request

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

Met un agent de veille en pause ou le réactive, le renomme, change sa mission ou sa fréquence. Une réactivation respecte le plafond d'agents actifs du compte. Le même appel répété laisse le même état. Exige une clé rattachée à un compte Pillr. Coût : 0 crédit par appel réussi.

## Path parameters

- `id` string, uuid, required: Identifiant de l'agent.

## Request body

- object
  - `actif` boolean
  - `nom` string
  - `mission` string
  - `frequence` 'immediate' | 'daily' | 'weekly'

## Response `200`

Écriture faite et débitée selon le barème.

- 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
  - `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)