---
title: "Demande un service absent du catalogue (lettre, calculateur, outil IA) pour votre organisation (gratuit)"
method: POST
path: "/v1/requests"
tags: ["B2B (v1)"]
---

# Demande un service absent du catalogue (lettre, calculateur, outil IA) pour votre organisation (gratuit)

`POST /v1/requests`

## Request

- Base URL: `https://api.vitef.com`
- URL: `https://api.vitef.com/v1/requests`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string: Rend la requête rejouable sans effet en double pendant 24 h (UUID v4 recommandé). Même clé et même requête : la première réponse est renvoyée avec `Idempotent-Replayed: true`, sans nouvel envoi ni nouveau débit. Même clé pour une autre requête : 422 `idempotency_key_reused`. Requête identique encore en cours : 409 `idempotency_in_progress`.

## Request body

- ServiceRequestInput
  - `kind` 'letter' | 'calculator' | 'ai_tool' | 'other': Nature du service demandé : lettre, calculateur, outil IA ou autre.
  - `message` string, required
  - `query` string: Recherche d’origine, si la demande suit une recherche sans résultat.
  - `source` string: Page d’où vient la demande (chemin).
  - `email` string, email: Facultatif : prévenu quand le service est en ligne.

## Response `201`

Demande enregistrée

- ServiceRequest
  - `id` string, required
  - `kind` 'letter' | 'calculator' | 'ai_tool' | 'other', required: Nature du service demandé : lettre, calculateur, outil IA ou autre.
  - `message` string, required
  - `query` string
  - `status` 'new' | 'planned' | 'done' | 'rejected', required: new : reçue ; planned : prévue ; done : en ligne ; rejected : non retenue.
  - `createdAt` string, required

## Other responses

- `400`: Requête invalide
- `401`: Authentification requise ou invalide
- `403`: Accès refusé (`insufficient_scope`, `account_suspended`, `live_not_enabled`)
- `409`: Requête identique encore en cours (`idempotency_in_progress`)
- `413`: Corps trop volumineux (`payload_too_large`)
- `422`: Clé Idempotency-Key déjà utilisée pour une autre requête (`idempotency_key_reused`)
- `429`: Trop de requêtes
- `500`: Erreur interne

---

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