Lister les budgets
Liste les budgets de l'organisation.
L'identifiant d'un budget sert à lire son pilotage, ses canaux et la revue de ses mois.
Appel
| Repère | Valeur |
|---|---|
| Adresse | GET /api/v1/budgets |
| Par son nom | POST /api/v1/tools/list_budgets, la réponse sous data |
| Nom de l'outil | list_budgets |
| Droit demandé | Lire le détail par canal, fournisseur et contrat (spendDetail.read) |
| Rôles qui ont ce droit par défaut | Propriétaire, CMO, Marketing Ops, DAF, Lecteur / auditeur |
| Par MCP | Oui, en lecture. |
Paramètres
Aucun paramètre.
Exemple
curl "$MARVESTO_URL/api/v1/budgets" \
-H "x-api-key: $MARVESTO_API_KEY"Réponse
budgets : pour chacun, son identifiant, son entité, son nom, son premier mois, sa version en vigueur et son brouillon en cours, s'il y en a un.
Refus
Un refus répond { "message": "…" }, en français, avec son statut HTTP : voir Droits et erreurs.