Démarrage rapide
De la création d’un jeton à votre première procédure créée par programme. Les exemples utilisent curl ; n’importe quel langage qui sait faire une requête HTTP convient.
1Créer un jeton
Dans l’application, ouvrez Paramètres › Options d’application › Mes jetons d’API, puis « Créer un jeton ». Donnez-lui un nom, cochez les droits dont votre programme a besoin, choisissez une durée.
Le jeton n’est affiché qu’une fois : copiez-le aussitôt et rangez-le comme un mot de passe. Pour un programme qui doit survivre au départ de son auteur, un administrateur peut créer un jeton d’organisation.
2Premier appel
Chaque requête présente le jeton dans l’en-tête Authorization. Demandez d’abord à l’API qui vous êtes :
curl https://beta.unwind-app.com/api/v1/me \
-H "Authorization: Bearer saw_pat_…"
Le navigateur a refusé la copie : sélectionnez le texte et copiez-le à la main.
{
"id": 42,
"name": "Camille Martin",
"kind": "user",
"organisation_id": null,
"scopes": ["read", "write"]
}
3Lire vos procédures
Vos classeurs et procédures vivent dans des espaces ; « me » est le vôtre. Listez ce qu’il contient, puis lisez les étapes d’une procédure :
# Ce qui se trouve à la racine de votre espace
curl https://beta.unwind-app.com/api/v1/spaces/me \
-H "Authorization: Bearer saw_pat_…"
# Les étapes de la procédure 128, dans l’ordre
curl https://beta.unwind-app.com/api/v1/flows/128/steps \
-H "Authorization: Bearer saw_pat_…"
Le navigateur a refusé la copie : sélectionnez le texte et copiez-le à la main.
Dans l’API, une procédure s’appelle flow et un classeur binder.
4Créer une procédure
Avec le droit « Modifier ». La procédure naît hors ligne, avec une première étape vide dans son brouillon.
curl -X POST https://beta.unwind-app.com/api/v1/flows \
-H "Authorization: Bearer saw_pat_…" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: onboarding-2026-10-05" \
-d '{"name": "Accueil des nouveaux arrivants"}'
Le navigateur a refusé la copie : sélectionnez le texte et copiez-le à la main.
L’en-tête Idempotency-Key est facultatif : renvoyée avec la même clé, la requête n’est pas exécutée deux fois. Remplissez ensuite les étapes, reliez-les par des boutons, puis publiez et mettez en ligne — deux gestes distincts, qui demandent le droit « Publier ».
5En cas d’erreur
Une erreur revient toujours sous la même forme : « code » est fait pour votre programme, « detail » pour vous. Ici, le jeton n’a pas le droit de publier :
{
"type": "about:blank",
"title": "Forbidden",
"status": 403,
"code": "insufficient_scope",
"detail": "",
"scope": "publish"
}
Un identifiant que le compte n’a pas le droit d’ouvrir répond comme un identifiant qui n’existe pas : 404 not_found.
Et ensuite
Référence de l’API — toutes les routes, leurs paramètres et leurs erreurs.
Connecter un assistant — le même accès, sans écrire de code.