---
title: "Ranger un texte dans un projet"
method: POST
path: "/projets/{id}/textes"
---

# Ranger un texte dans un projet

`POST /projets/{id}/textes`

## Request

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

Range un texte long dans un projet (modèle de courrier, texte de boîtage) : même préparation que le site, coordonnées remplacées par une mention, données sensibles refusées, dédoublonnage et plafond de textes par projet. Le Hub le réinjecte dans les conversations du projet. Exige une clé rattachée à un compte Pillr. Coût : 0 crédit par appel réussi.

## Path parameters

- `id` string, uuid, required: Identifiant du projet.

## Request body

- object
  - `libelle` string, required
  - `texte` string, required

## Response `200`

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

- object
  - `range` boolean, required
  - `deja_range` boolean, required
  - `empreinte` string, required
  - `masques` integer, required: Coordonnées remplacées par une mention dans le texte rangé.
  - `oublies` string[], required: Libellés des textes sortis parce que le plafond était atteint.
  - `total` integer, required
  - `plafond` 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)