Référence de l'API

Créer un projet

Crée un projet vide dans l'équipe de la clé.

POST/v11/projects

Vous pouvez aussi vous en passer : le premier déploiement sur un nom inconnu crée le projet.

Requête

En-têtes

Authorizationstringrequis: Bearer ah_…, votre clé d'API.

Corps

namestringrequis: Nom du projet, 100 caractères au plus. Il devient le nom dans l'URL, en minuscules.
frameworkstring | null: Framework : nextjs, astro, vite, sveltekit, nuxt, tanstack-start, react-router. Toute autre valeur enregistre un site sans framework.

curl -X POST https://api.host.hgdc.ch/v11/projects \
  -H "Authorization: Bearer $SMARTFLOW_HOST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"site-atelier","framework":"astro"}'

Réponse

L'objet projet créé, décrit sur Lire un projet.

200

{
  "id": "j97d3k2m8x1q4p6s7t9v0w2y5z",
  "name": "site-atelier",
  "accountId": "k57a1b2c3d4e5f6g7h8j9k0m1n",
  "framework": "astro",
  "rootDirectory": null,
  "buildCommand": null,
  "installCommand": null,
  "outputDirectory": null,
  "nodeVersion": "24.x",
  "createdAt": 1760259600000,
  "updatedAt": 1760259600000
}

Erreurs

Statut	Code	Quand
400	`bad_request`	Nom absent ou trop long.
403	`forbidden`	La clé est limitée à un projet : elle ne crée rien.
409	`conflict`	Un projet porte déjà ce nom.

Toutes les routes peuvent aussi répondre 403 forbidden, 429 rate_limited et 500 internal_server_error. Voir Erreurs.