---
title: "Créer un projet"
method: POST
path: "/projets"
---

# Créer un projet

`POST /projets`

## Request

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

Crée un projet dans le compte de l'utilisateur de la clé : type, titre, adresse en texte, annonce suivie. Une clé BAN donnée est rangée dans les faits du projet. Le Hub réinjecte le projet dans chaque conversation qui lui est rattachée. Exige une clé rattachée à un compte Pillr. Coût : 0 crédit par appel réussi.

## Request body

- object
  - `type` 'achat' | 'vente_mandat' | 'location_gestion', required: achat, vente_mandat ou location_gestion.
  - `titre` string, required
  - `adresse` string: Adresse du bien, en texte.
  - `cle_ban` string: Clé d'interopérabilité de la Base Adresse Nationale, ex. 69383_1234_00012.
  - `annonce` string: Annonce suivie par le projet.

## Response `201`

Ressource créée.

- object
  - `projet` object, required
    - `id` string, uuid, required
    - `type` string, required
    - `titre` string, required
    - `etape` string, required
    - `annonce_id` string, nullable, required: Identifiant Pillr de l'annonce suivie.
    - `adresse` string, nullable, required
    - `faits` object, required: Faits du projet (clés libres ; textes et urbanisme sont réservés).
    - `echeances` object[], required
    - `clos_le` string, nullable, required: Horodatage ISO 8601.
    - `cree_le` string, nullable, required: Horodatage ISO 8601.
    - `maj_le` string, nullable, required: Horodatage ISO 8601.
    - `nb_conversations` integer, 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 ; Donnée momentanément 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)