Rechercher dans la documentation

Tapez pour filtrer les pages, les guides et les endpoints.

POST/api/v1/projects

Créer un projet

Crée un projet pour un client — existant, ou créé à la volée — et renvoie le lien de son portail.

Crée un projet. Un projet sans client n'existe pas : fournissez client_id pour rattacher un client existant, ou client_name pour le créer en même temps. La réponse contient portal_url, le lien à transmettre au client.

Corps de la requête

ChampTypeRequisContraintes
titlestringoui1 à 200 caractères
descriptionstring5 000 caractères max
client_idstringl'un des deuxClient existant de l'organisation
client_namestringl'un des deux1 à 200 caractères ; crée le client
product_idstringRattache un produit et son échéancier de paiement

Si client_id et client_name sont tous deux fournis, client_id gagne.

Cette route accepte un en-tête Idempotency-Key — recommandé ici : une création rejouée par erreur produirait un second projet et un second portail.

Exemple

curl -X POST "https://www.tetikasa.app/api/v1/projects" \
  -H "Authorization: Bearer $TETIKASA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"title":"Refonte du site vitrine","client_name":"Acme"}'

Réponse

Statut 201. Le slug est dérivé du titre, unique dans toute l'application, et ne change jamais ensuite — même si le projet est renommé.

Erreurs

codeStatutQuand
invalid_request422Corps invalide, ou ni client_id ni client_name
not_found404client_id (ou product_id) inconnu dans cette organisation
forbidden403L'organisation n'a pas de plan : la création de projets demande un abonnement
unauthorized401Clé absente, invalide, révoquée ou expirée

Documentation liée

PrivacyTermsapp icon