Référence de l'API

get/sites

Lister les sites Tous les sites que vous voyez (un jeton limité à une équipe ne voit que les siens).

Jeton : read ou deployTout rôle d'équipelistSites

Paramètres

Réponses

• 200 Les sites, par nom

  application/json · liste de Site

• 401 Aucun jeton d'API ou session valide
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/sites" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

post/sites

Créer un site Crée un site vide, servi à https://<nom>.liftpad.ca dès qu'un déploiement est publié. Indiquez team si vous faites partie de plusieurs équipes.

Jeton : deployDéveloppeur, administrateur ou propriétairecreateSite

Corps de la requête

application/json · object

Réponses

• 201 Créé

  application/json · object

  Champ	Type	Description
  id requis	string
  name requis	string
  team requis	string
  url requis	string

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 402 Une limite du forfait ou un problème de facturation (error : plan_limit, credits, billing)
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 409 En conflit avec l'état actuel (voir error)
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS -X POST "https://api.liftpad.app/v1/sites" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN" \
  -H "content-type: application/json" \
  -d '{"name":"my-site","team":"my-agency"}'

get/sites/{name}

Obtenir un site

Jeton : read ou deployTout rôle d'équipegetSite

Paramètres

Réponses

• 200 Le site

  application/json · SiteDetail

  Champ	Type	Description
  id requis	string	Identifiant du site
  name requis	string	Nom du site : 3 à 40 caractères, a-z, 0-9 et traits d'union simples
  team_id	string ou null	Identifiant de l'équipe propriétaire du site
  primary_domain	string ou null	Le domaine personnalisé principal, ou null pour l'adresse liftpad.ca
  live_deploy_id	string ou null	Le déploiement en ligne, ou null si rien n'est publié
  created_at	integer	Création du site (millisecondes depuis 1970, UTC)
  updated_at	integer	Dernière modification (millisecondes depuis 1970, UTC)
  suspended_at	integer ou null	Suspension du site par Liftpad (millisecondes depuis 1970, UTC), ou null
  functions	liste de string ou null	Noms des fonctions du site, ou null
  access	string ou null: all, previews, null	Portée du mot de passe visiteur (all ou previews), ou null
  url requis	string (uri)	L'adresse du site sur liftpad.ca
  live	LiveRecord ou null	Le pointeur de mise en ligne, ou null
  domains requis	liste de object	Domaines personnalisés du site Champ Type Description hostname string created_at integer

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/sites/my-site" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

delete/sites/{name}

Supprimer un site Met le site hors ligne pour de bon, libère ses domaines et son nom. Envoyez le nom du site dans confirm.

Session du tableau de bord seulementPropriétairedeleteSite

Paramètres

Corps de la requête

application/json · object

Réponses

• 200 Supprimé

  application/json · Ok

  Champ	Type	Description
  ok requis	true

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 409 En conflit avec l'état actuel (voir error)
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)
• 502 Un service externe (Cloudflare, le registraire, Stripe) n'a pas répondu; réessayez

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 forbidden
curl -sS -X DELETE "https://api.liftpad.app/v1/sites/my-site" \
  -H "content-type: application/json" \
  -d '{"confirm":"my-site"}'

post/sites/{name}/transfer

Déplacer un site vers une autre équipe Pour un propriétaire des deux équipes. Fichiers, déploiements et domaines suivent le site, dans les limites du forfait de l'équipe qui le reçoit.

Session du tableau de bord seulementPropriétairetransferSite

Paramètres

Corps de la requête

application/json · object

Réponses

• 200 Déplacé

  application/json · object

  Champ	Type	Description
  ok requis	boolean
  site requis	string
  team requis	string

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 402 Une limite du forfait ou un problème de facturation (error : plan_limit, credits, billing)
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 409 En conflit avec l'état actuel (voir error)
• 413 Trop gros pour le forfait ou les limites
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 forbidden
curl -sS -X POST "https://api.liftpad.app/v1/sites/my-site/transfer" \
  -H "content-type: application/json" \
  -d '{"team":"client-team"}'

get/overview

Sites avec état de santé et dernière publication

Jeton : read ou deployTout rôle d'équipegetOverview

Paramètres

Réponses

• 200 Vue d'ensemble

  application/json · Overview

  Champ	Type	Description
  platform requis	string	Le domaine du tableau de bord
  sites requis	liste de object	Champ Type Description id string Identifiant du site name requis string Nom du site : 3 à 40 caractères, a-z, 0-9 et traits d'union simples team_id string ou null Identifiant de l'équipe propriétaire du site primary_domain string ou null Le domaine personnalisé principal, ou null pour l'adresse liftpad.ca live_deploy_id string ou null Le déploiement en ligne, ou null si rien n'est publié created_at integer Création du site (millisecondes depuis 1970, UTC) updated_at integer Dernière modification (millisecondes depuis 1970, UTC) suspended_at integer ou null Suspension du site par Liftpad (millisecondes depuis 1970, UTC), ou null functions liste de string ou null Noms des fonctions du site, ou null access string ou null: all, previews, null Portée du mot de passe visiteur (all ou previews), ou null url requis string (uri) L'adresse du site sur liftpad.ca team_slug string ou null team_name string ou null health_ok integer ou null 1 si la dernière vérification est réussie, 0 sinon, null avant la première health_detail object ou null Détails de la dernière vérification health_at integer ou null Dernière vérification (millisecondes depuis 1970, UTC), ou null deploy_count integer live_title string ou null Message du déploiement en ligne live_published_at integer ou null Publication du déploiement en ligne (millisecondes depuis 1970, UTC), ou null live_files integer ou null Fichiers du déploiement en ligne domain_count integer platformUrl string L'adresse liftpad.ca (url est le domaine principal s'il y en a un)

• 401 Aucun jeton d'API ou session valide
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/overview" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

get/sites/{name}/manifest

Obtenir le manifeste d'un déploiement Chaque chemin avec son SHA-256, sa taille et son type, et les règles du déploiement. Sert aux exportations et à deploy_changes.

Jeton : deployDéveloppeur, administrateur ou propriétairegetManifest

Paramètres

Réponses

• 200 Le manifeste

  application/json · Manifest

  Champ	Type	Description
  v requis	integer
  id requis	string	Identifiant du déploiement
  siteId	string
  createdAt	integer
  files requis	table de n-uplet	Chemin vers [sha256, taille, type de contenu]
  redirects requis	liste de object	Règles de redirection, dans l'ordre
  headers requis	liste de object	Règles d'en-têtes
  forms	table de object	Formulaires trouvés dans les pages

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/sites/my-site/manifest" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

get/sites/{name}/files/{hash}

Télécharger un fichier d'un déploiement Même droit que le manifeste : les fichiers comprennent les règles du site (mots de passe Basic-Auth) et les pages protégées. Toujours envoyé en téléchargement.

Jeton : deployDéveloppeur, administrateur ou propriétairegetSiteFile

Paramètres

Réponses

• 200 Le contenu du fichier

  application/octet-stream · string (binary)

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/sites/my-site/files/SHA256" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

get/sites/{name}/functions

Obtenir les fonctions du site Les fonctions sont en alpha : seuls les opérateurs de Liftpad peuvent les déployer pour l'instant.

Jeton : read ou deployTout rôle d'équipegetFunctions

Paramètres

Réponses

• 200 Fonctions, ou null

  application/json · Functions ou null

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/sites/my-site/functions" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

post/sites/{name}/deploys

Commencer un déploiement Envoyez chaque chemin avec le SHA-256 de son contenu. La réponse donne les empreintes que Liftpad n'a pas encore : envoyez seulement celles-là, puis finalisez. Les fichiers déjà envoyés par votre équipe sont réutilisés.

Jeton : deployDéveloppeur, administrateur ou propriétairecreateDeploy

Paramètres

Corps de la requête

application/json · object

Réponses

• 201 Déploiement commencé

  application/json · object

  Champ	Type	Description
  id requis	string
  required requis	liste de string	Empreintes à envoyer
  previewUrl requis	string

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 402 Une limite du forfait ou un problème de facturation (error : plan_limit, credits, billing)
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 413 Trop gros pour le forfait ou les limites
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS -X POST "https://api.liftpad.app/v1/sites/my-site/deploys" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN" \
  -H "content-type: application/json" \
  -d '{"files":{"/index.html":"3a1f0c8e5b0d2d8f9c4e1a7b6d5c4b3a2f1e0d9c8b7a6f5e4d3c2b1a0f9e8d7c","/style.css":"9f8e7d6c5b4a39281706f5e4d3c2b1a0f9e8d7c6b5a493827160f5e4d3c2b1a0"},"title":"First deploy"}'

get/sites/{name}/deploys

Lister les déploiements d'un site Les 100 plus récents.

Jeton : read ou deployTout rôle d'équipelistDeploys

Paramètres

Réponses

• 200 Déploiements, du plus récent au plus ancien

  application/json · liste de DeployListItem

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/sites/my-site/deploys" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

put/deploys/{id}/blobs/{hash}

Envoyer un fichier Le contenu brut d'un fichier demandé par le déploiement, avec Content-Length. Liftpad vérifie le contenu par rapport à l'empreinte. Jusqu'à 100 Mo par fichier.

Jeton : deployDéveloppeur, administrateur ou propriétaireuploadDeployFile

Paramètres

Corps de la requête

application/octet-stream · string (binary)

Réponses

• 200 Enregistré

  application/json · object

  Champ	Type	Description
  ok requis	boolean
  hash requis	string
  size requis	integer

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 409 En conflit avec l'état actuel (voir error)
• 411 En-tête Content-Length requis
• 413 Trop gros pour le forfait ou les limites
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS -X PUT "https://api.liftpad.app/v1/deploys/ID/blobs/SHA256" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN" \
  -H "content-type: application/octet-stream" \
  --data-binary @public/index.html

post/deploys/{id}/finalize

Terminer un déploiement Lit les règles et les formulaires, lance les vérifications de lancement et active l'adresse d'aperçu. S'il manque des fichiers, la réponse est 409 missing_blobs avec les empreintes à envoyer; envoyez-les et rappelez. Sur un déploiement déjà prêt, la réponse est de nouveau ready.

Jeton : deployDéveloppeur, administrateur ou propriétairefinalizeDeploy

Paramètres

Réponses

• 200 Prêt

  application/json · object

  Champ	Type	Description
  id requis	string
  state requis	"ready"
  previewUrl	string
  summary	DeploySummary
  held	boolean	Retenu pour une vérification de sécurité
  message	string

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 409 En conflit avec l'état actuel (voir error)
• 413 Trop gros pour le forfait ou les limites
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS -X POST "https://api.liftpad.app/v1/deploys/ID/finalize" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

get/deploys/{id}

Obtenir un déploiement

Jeton : read ou deployTout rôle d'équipegetDeploy

Paramètres

Réponses

• 200 Le déploiement

  application/json · Deploy

  Champ	Type	Description
  id requis	string	Identifiant du déploiement
  site_id	string
  site_name	string
  team_id	string ou null
  state requis	string: uploading, ready, expired	uploading jusqu'à la finalisation, puis ready
  title	string ou null	Le message du déploiement
  file_count	integer
  total_size	integer	Octets
  created_at	integer	Début (millisecondes depuis 1970, UTC)
  ready_at	integer ou null	Finalisation (millisecondes depuis 1970, UTC), ou null
  published_at	integer ou null	Dernière publication (millisecondes depuis 1970, UTC), ou null
  held requis	boolean	Vrai tant qu'une vérification de sécurité de Liftpad le retient (publication impossible)
  required requis	liste de string	Fichiers encore à envoyer (pendant l'envoi)
  summary	object ou null	Présent une fois prêt

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/deploys/ID" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

get/deploys/{id}/checks

Vérifications de lancement d'un déploiement Liens brisés, fichiers manquants, titres, descriptions, texte de remplacement, contenu non sécurisé, images lourdes, plan du site, robots.txt et plus, lus dans jusqu'à 400 pages.

Jeton : read ou deployTout rôle d'équipegetDeployChecks

Paramètres

Réponses

• 200 Le rapport

  application/json · CheckReport

  Champ	Type	Description
  v	integer
  score requis	integer	0 à 100
  pages requis	integer	Pages HTML lues
  counts requis	object	Nombre de problèmes par niveau Champ Type Description error integer warning integer info integer
  issues requis	liste de object	Champ Type Description level requis string: error, warning, info code requis string Code stable, par exemple broken_link ou missing_alt page requis string ou null La page, ou null pour tout le site detail requis string ref string Le fichier concerné, s'il y en a un
  truncated	boolean	Vrai si la liste a été coupée

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/deploys/ID/checks" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

post/deploys/{id}/suggest

Titre et description d'une page par IA Rédigés à partir du texte de la page. Utilise les suggestions IA mensuelles du forfait; un contenu déjà traité est servi gratuitement.

Jeton : deployDéveloppeur, administrateur ou propriétairesuggestPageMeta

Paramètres

Corps de la requête

application/json · object

Réponses

• 200 Suggestion

  application/json · object

  Champ	Type	Description
  title requis	string
  description requis	string
  cached requis	boolean
  left	integer	Suggestions restantes ce mois-ci

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 422 L'IA n'a pas trouvé de réponse sûre cette fois
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS -X POST "https://api.liftpad.app/v1/deploys/ID/suggest" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN" \
  -H "content-type: application/json" \
  -d '{"page":"/about.html"}'

post/deploys/{id}/alt

Texte de remplacement d'une image par IA Un modèle de vision décrit une image du déploiement en une phrase, dans la langue de la page.

Jeton : deployDéveloppeur, administrateur ou propriétairesuggestImageAlt

Paramètres

Corps de la requête

application/json · object

Réponses

• 200 Texte de remplacement

  application/json · object

  Champ	Type	Description
  alt requis	string
  lang	string
  src	string
  cached requis	boolean

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 422 L'IA n'a pas trouvé de réponse sûre cette fois
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS -X POST "https://api.liftpad.app/v1/deploys/ID/alt" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN" \
  -H "content-type: application/json" \
  -d '{"page":"/index.html","src":"img/team.jpg"}'

post/sites/{name}/publish

Publier un déploiement (ou revenir en arrière) Met un déploiement prêt en ligne partout en environ 5 secondes. Publier un ancien déploiement est un retour arrière. Met fin à un test A/B en cours.

Jeton : deployDéveloppeur, administrateur ou propriétairepublishDeploy

Paramètres

Corps de la requête

application/json · object

Réponses

• 200 En ligne

  application/json · object

  Champ	Type	Description
  site requis	string
  deployId requis	string
  generation requis	integer
  url requis	string	L'adresse en ligne (domaine principal s'il y en a un)

• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 409 En conflit avec l'état actuel (voir error)
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)
• 503 Pas encore offert sur ce Liftpad, ou indisponible un moment

Exemple

curl -sS -X POST "https://api.liftpad.app/v1/sites/my-site/publish" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN" \
  -H "content-type: application/json" \
  -d '{"deployId":"k2j4h6g8f0d2"}'

post/sites/{name}/unpublish

Mettre un site hors ligne Rien n'est supprimé : publiez un déploiement pour le remettre en ligne.

Jeton : deployDéveloppeur, administrateur ou propriétaireunpublishSite

Paramètres

Réponses

• 200 Hors ligne

  application/json · Ok

  Champ	Type	Description
  ok requis	true

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS -X POST "https://api.liftpad.app/v1/sites/my-site/unpublish" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

post/sites/{name}/domains

Connecter un domaine que vous possédez Répond avec les enregistrements DNS à ajouter. HTTPS démarre dès que le DNS pointe vers Liftpad. Avec primary, le domaine devient l'adresse principale dès qu'il est prêt.

Jeton : deployDéveloppeur, administrateur ou propriétaireaddDomain

Paramètres

Corps de la requête

application/json · object

Réponses

• 201 Ajouté

  application/json · object

  Champ	Type	Description
  hostname requis	string
  site	string
  primary	boolean
  mainWhenReady	boolean
  status requis	string
  sslStatus	string
  records requis	liste de object

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 402 Une limite du forfait ou un problème de facturation (error : plan_limit, credits, billing)
• 404 Introuvable, ou invisible pour vous
• 409 En conflit avec l'état actuel (voir error)
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)
• 502 Un service externe (Cloudflare, le registraire, Stripe) n'a pas répondu; réessayez

Exemple

curl -sS -X POST "https://api.liftpad.app/v1/sites/my-site/domains" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN" \
  -H "content-type: application/json" \
  -d '{"hostname":"www.example.com","primary":true}'

get/sites/{name}/domains

Lister les domaines d'un site Avec l'état DNS et du certificat à jour (vérifié au plus une fois par minute).

Jeton : read ou deployTout rôle d'équipelistDomains

Paramètres

Réponses

• 200 Domaines

  application/json · liste de Domain

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/sites/my-site/domains" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

delete/sites/{name}/domains/{hostname}

Retirer un domaine Un domaine acheté sur Liftpad reste connecté tant qu'il est enregistré.

Jeton : deployDéveloppeur, administrateur ou propriétaireremoveDomain

Paramètres

Réponses

• 200 Retiré

  application/json · Ok

  Champ	Type	Description
  ok requis	true

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 409 En conflit avec l'état actuel (voir error)
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)
• 502 Un service externe (Cloudflare, le registraire, Stripe) n'a pas répondu; réessayez

Exemple

curl -sS -X DELETE "https://api.liftpad.app/v1/sites/my-site/domains/www.example.com" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

post/sites/{name}/primary

Choisir l'adresse principale Les visiteurs des autres adresses sont envoyés vers la principale. null revient à l'adresse liftpad.ca. Un domaine pas encore prêt deviendra principal automatiquement (409 domain_not_ready).

Jeton : deployDéveloppeur, administrateur ou propriétairesetPrimaryDomain

Paramètres

Corps de la requête

application/json · object

Réponses

• 200 Choisie

  application/json · object

  Champ	Type	Description
  ok requis	boolean
  primary requis	string ou null

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 409 En conflit avec l'état actuel (voir error)
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS -X POST "https://api.liftpad.app/v1/sites/my-site/primary" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN" \
  -H "content-type: application/json" \
  -d '{"hostname":"www.example.com"}'

get/domains/search

Chercher des noms de domaine Un nom est-il libre, et son prix en CAD. Aucune connexion requise. Les mêmes noms sont gardés en cache dix minutes.

Sans connexionsearchDomains

Paramètres

Réponses

• 200 Résultats

  application/json · DomainSearch

  Champ	Type	Description
  query requis	string
  exact	string ou null	Le nom complet demandé, si la recherche en était un
  currency	"CAD"
  results requis	liste de object	Champ Type Description name requis string available requis boolean priceCad number Première année, CAD, taxes en sus renewCad number Chaque année suivante, CAD includable boolean Couvert par le domaine inclus du forfait Business reason string Pourquoi un nom n'est pas offert

• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)
• 502 Un service externe (Cloudflare, le registraire, Stripe) n'a pas répondu; réessayez
• 503 Pas encore offert sur ce Liftpad, ou indisponible un moment

Exemple

curl -sS "https://api.liftpad.app/v1/domains/search?q=boulangerie"

get/sites/{name}/domain-orders

Commandes de domaines d'un site

Jeton : read ou deployTout rôle d'équipelistDomainOrders

Paramètres

Réponses

• 200 Commandes

  application/json · object

  Champ	Type	Description
  orders requis	liste de DomainOrder
  includedLeft	integer	Domaines inclus restants cette année
  includedPlan	boolean
  ready	boolean	La vente de domaines est ouverte
  payments	boolean	Le paiement en ligne est ouvert

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/sites/my-site/domain-orders" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

post/sites/{name}/domains/buy

Acheter un domaine pour un site Propriétaires et administrateurs, depuis le tableau de bord. Utilise le domaine inclus au forfait s'il couvre le nom; sinon répond avec une adresse de paiement Stripe, ou transmet la demande à Liftpad si le paiement en ligne n'est pas ouvert.

Session du tableau de bord seulementAdministrateur ou propriétairebuyDomain

Paramètres

Corps de la requête

application/json · object

Réponses

• 201 Commandé

  application/json · object

  Champ	Type	Description
  order requis	DomainOrder
  checkoutUrl	string	Page de paiement Stripe, si un paiement est requis

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 402 Une limite du forfait ou un problème de facturation (error : plan_limit, credits, billing)
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 409 En conflit avec l'état actuel (voir error)
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)
• 502 Un service externe (Cloudflare, le registraire, Stripe) n'a pas répondu; réessayez
• 503 Pas encore offert sur ce Liftpad, ou indisponible un moment

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X POST "https://api.liftpad.app/v1/sites/my-site/domains/buy" \
  -H "content-type: application/json" \
  -d '{"domain":"yourbusiness.ca"}'

get/sites/{name}/forms

Lister les formulaires Formulaires du déploiement en ligne, avec le nombre d'envois reçus.

Jeton : read ou deployTout rôle d'équipelistForms

Paramètres

Réponses

• 200 Formulaires

  application/json · object

  Champ	Type	Description
  allowance	integer ou null	Envois par mois au forfait
  forms requis	liste de Form

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/sites/my-site/forms" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

get/sites/{name}/submissions

Lister les envois de formulaire Du plus récent au plus ancien. Passez next comme before pour la page suivante.

Jeton : read ou deployTout rôle d'équipelistSubmissions

Paramètres

Réponses

• 200 Une page d'envois

  application/json · object

  Champ	Type	Description
  submissions requis	liste de Submission
  next requis	integer ou null	Valeur pour before, ou null à la fin

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/sites/my-site/submissions" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

get/sites/{name}/forms/{form}/submissions.csv

Télécharger les envois en CSV Tous les envois d'un formulaire, sûrs à ouvrir dans un tableur (les valeurs qui seraient lues comme formules sont neutralisées). Jusqu'à 50 000 lignes.

Jeton : read ou deployTout rôle d'équipeexportSubmissionsCsv

Paramètres

Réponses

• 200 Fichier CSV

  text/csv · string

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/sites/my-site/forms/contact/submissions.csv" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

get/sites/{name}/submissions/{id}/files/{i}

Télécharger un fichier joint à un envoi Toujours envoyé en téléchargement, jamais affiché (il vient d'un visiteur).

Jeton : read ou deployTout rôle d'équipegetSubmissionFile

Paramètres

Réponses

• 200 Le fichier

  application/octet-stream · string (binary)

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/sites/my-site/submissions/ID/files/0" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

patch/sites/{name}/submissions/{id}

Marquer comme indésirable ou non

Jeton : deployDéveloppeur, administrateur ou propriétairemarkSubmission

Paramètres

Corps de la requête

application/json · object

Réponses

• 200 Enregistré

  application/json · Ok

  Champ	Type	Description
  ok requis	true

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS -X PATCH "https://api.liftpad.app/v1/sites/my-site/submissions/ID" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN" \
  -H "content-type: application/json" \
  -d '{"spam":true}'

delete/sites/{name}/submissions/{id}

Supprimer un envoi Ses fichiers sont aussi supprimés.

Jeton : deployDéveloppeur, administrateur ou propriétairedeleteSubmission

Paramètres

Réponses

• 200 Supprimé

  application/json · Ok

  Champ	Type	Description
  ok requis	true

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS -X DELETE "https://api.liftpad.app/v1/sites/my-site/submissions/ID" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

post/sites/{name}/submissions/import

Importer des envois d'un autre hébergeur Jusqu'à 500 par appel. Les dates sont gardées, personne n'est avisé par courriel et les fichiers ne sont pas copiés. Le même id envoyé deux fois n'est importé qu'une fois.

Jeton : deployDéveloppeur, administrateur ou propriétaireimportSubmissions

Paramètres

Corps de la requête

application/json · object

Réponses

• 200 Importés

  application/json · object

  Champ	Type	Description
  ok requis	boolean
  imported requis	integer
  skipped requis	integer

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS -X POST "https://api.liftpad.app/v1/sites/my-site/submissions/import" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN" \
  -H "content-type: application/json" \
  -d '{"submissions":[{"id":"abc123","form":"contact","data":{"name":"Sam","message":"Hello"},"createdAt":1767225600000}]}'

get/sites/{name}/snippets

Obtenir les extraits de code

Jeton : read ou deployTout rôle d'équipegetSnippets

Paramètres

Réponses

• 200 Extraits

  application/json · liste de Snippet

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/sites/my-site/snippets" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

put/sites/{name}/snippets

Remplacer les extraits de code La liste complète : jusqu'à 10 extraits, 20 000 caractères chacun, 50 000 en tout, ajoutés à chaque page HTML sans déploiement. Forfaits payants seulement.

Jeton : deployDéveloppeur, administrateur ou propriétairesetSnippets

Paramètres

Corps de la requête

application/json · object

Réponses

• 200 La liste enregistrée

  application/json · liste de Snippet

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 402 Une limite du forfait ou un problème de facturation (error : plan_limit, credits, billing)
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS -X PUT "https://api.liftpad.app/v1/sites/my-site/snippets" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN" \
  -H "content-type: application/json" \
  -d '{"snippets":[{"name":"Analytics","where":"head","html":"<script defer src=\"https://example.com/a.js\"></script>"}]}'

get/sites/{name}/split

Obtenir le test A/B

Jeton : read ou deployTout rôle d'équipegetSplitTest

Paramètres

Réponses

• 200 Le test, ou null

  application/json · SplitTest ou null

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/sites/my-site/split" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

put/sites/{name}/split

Lancer, modifier ou arrêter un test A/B Une part des visiteurs du site en ligne (1 à 99 %) voit un autre déploiement prêt. Envoyez deployId null pour arrêter.

Jeton : deployDéveloppeur, administrateur ou propriétairesetSplitTest

Paramètres

Corps de la requête

application/json · object

Réponses

• 200 Le test, ou null

  application/json · SplitTest ou null

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 409 En conflit avec l'état actuel (voir error)
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS -X PUT "https://api.liftpad.app/v1/sites/my-site/split" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN" \
  -H "content-type: application/json" \
  -d '{"deployId":"k2j4h6g8f0d2","percent":20}'

get/sites/{name}/access

État du mot de passe visiteur

Jeton : read ou deployTout rôle d'équipegetVisitorAccess

Paramètres

Réponses

• 200 État

  application/json · object

  Champ	Type	Description
  enabled requis	boolean
  scope requis	string ou null: all, previews, null
  updatedAt	integer ou null

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/sites/my-site/access" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

put/sites/{name}/access

Définir ou retirer le mot de passe visiteur Une page de mot de passe devant tout le site ou seulement ses aperçus. password null le retire. Le changer déconnecte tous les visiteurs. Impossible avec un jeton d'API.

Session du tableau de bord seulementDéveloppeur, administrateur ou propriétairesetVisitorAccess

Paramètres

Corps de la requête

application/json · object

Réponses

• 200 Enregistré

  application/json · object

  Champ	Type	Description
  ok requis	boolean
  enabled requis	boolean
  scope	string ou null

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X PUT "https://api.liftpad.app/v1/sites/my-site/access" \
  -H "content-type: application/json" \
  -d '{"password":"a long shared password","scope":"previews"}'

get/sites/{name}/hooks

Lister les notifications Webhooks et messages Slack d'un site. Session du tableau de bord seulement.

Session du tableau de bord seulementDéveloppeur, administrateur ou propriétairelistHooks

Paramètres

Réponses

• 200 Notifications

  application/json · liste de Hook

• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS "https://api.liftpad.app/v1/sites/my-site/hooks"

post/sites/{name}/hooks

Ajouter une notification Un webhook signé ou un webhook entrant Slack pour certains de : deploy.ready, deploy.published, form.submission. Adresses https publiques seulement, jamais Liftpad ni un site qu'il héberge. Jusqu'à 10 par site. Le secret de signature d'un webhook n'apparaît que dans cette réponse.

Session du tableau de bord seulementDéveloppeur, administrateur ou propriétairecreateHook

Paramètres

Corps de la requête

application/json · object

Réponses

• 201 Ajoutée

  application/json · object

  Champ	Type	Description
  id requis	string
  kind requis	string: webhook, slack
  url requis	string	Où les événements sont envoyés (adresses Slack raccourcies)
  events requis	liste de string: deploy.ready, deploy.published, form.submission
  createdAt	integer
  lastStatus	integer ou null	Statut HTTP du dernier envoi (0 si la connexion a échoué)
  lastAt	integer ou null
  paused	boolean	Vrai après 50 envois ratés de suite
  secret	string	Secret de signature (lpwh_...), montré une fois

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X POST "https://api.liftpad.app/v1/sites/my-site/hooks" \
  -H "content-type: application/json" \
  -d '{"kind":"webhook","url":"https://example.com/liftpad","events":["deploy.published","form.submission"]}'

post/sites/{name}/hooks/{id}/test

Envoyer une notification d'essai

Session du tableau de bord seulementDéveloppeur, administrateur ou propriétairetestHook

Paramètres

Réponses

• 200 Résultat de l'envoi

  application/json · object

  Champ	Type	Description
  status requis	integer	Statut HTTP du destinataire (0 si la connexion a échoué)
  ok requis	boolean

• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X POST "https://api.liftpad.app/v1/sites/my-site/hooks/ID/test"

delete/sites/{name}/hooks/{id}

Retirer une notification

Session du tableau de bord seulementDéveloppeur, administrateur ou propriétairedeleteHook

Paramètres

Réponses

• 200 Retirée

  application/json · Ok

  Champ	Type	Description
  ok requis	true

• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X DELETE "https://api.liftpad.app/v1/sites/my-site/hooks/ID"

get/sites/{name}/analytics

Statistiques de visite

Jeton : read ou deployTout rôle d'équipegetAnalytics

Paramètres

Réponses

• 200 Statistiques

  application/json · Analytics

  Champ	Type	Description
  enabled requis	boolean	Faux si les statistiques ne sont pas activées sur ce Liftpad
  days	integer
  views	integer
  visitors	integer
  daily	liste de object	Champ Type Description day string views integer visitors integer
  pages	liste de object	Champ Type Description path string views integer

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)
• 503 Pas encore offert sur ce Liftpad, ou indisponible un moment

Exemple

curl -sS "https://api.liftpad.app/v1/sites/my-site/analytics" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

post/sites/{name}/ai-build

Créer un site par IA Rédige, illustre et construit un site complet à partir d'une courte description, en déploiement brouillon. Coûte 100 crédits, remis si la tâche échoue. Session du tableau de bord seulement.

Session du tableau de bord seulementDéveloppeur, administrateur ou propriétaireaiBuildSite

Paramètres

Corps de la requête

application/json · object

Réponses

• 202 En file

  application/json · object

  Champ	Type	Description
  job requis	object	Champ Type Description id string kind string status string credits integer

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 402 Une limite du forfait ou un problème de facturation (error : plan_limit, credits, billing)
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X POST "https://api.liftpad.app/v1/sites/my-site/ai-build" \
  -H "content-type: application/json" \
  -d '{"name":"Boulangerie Lune","about":"A neighbourhood bakery in Montreal with sourdough and pastries.","langs":["fr","en"],"style":"warm"}'

post/sites/{name}/ai-edit

Modifier en mots un site créé par IA Coûte 20 crédits, plus 10 avec newImages. Session du tableau de bord seulement.

Session du tableau de bord seulementDéveloppeur, administrateur ou propriétaireaiEditSite

Paramètres

Corps de la requête

application/json · object

Réponses

• 202 En file

  application/json · object

  Champ	Type	Description
  job requis	object	Champ Type Description id string kind string status string credits integer

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 402 Une limite du forfait ou un problème de facturation (error : plan_limit, credits, billing)
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 409 En conflit avec l'état actuel (voir error)
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X POST "https://api.liftpad.app/v1/sites/my-site/ai-edit" \
  -H "content-type: application/json" \
  -d '{"instruction":"Add our Sunday hours: 9 to 2."}'

get/sites/{name}/ai

Tâches IA d'un site

Jeton : read ou deployTout rôle d'équipegetAiJobs

Paramètres

Réponses

• 200 Tâches

  application/json · object

  Champ	Type	Description
  aiSite requis	boolean	Créé avec le créateur IA
  jobs requis	liste de AiJob
  costs requis	table de integer
  credits	object ou null	Montré aux propriétaires, administrateurs, facturation et développeurs

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/sites/my-site/ai" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

get/me

Qui suis-je L'appelant, ses équipes et ses rôles. Avec un jeton, les rôles sont ce que le jeton peut faire.

Jeton : read ou deployTout rôle d'équipegetMe

Réponses

• 200 Vous

  application/json · Me

  Champ	Type	Description
  kind requis	string: session, token	Mode de connexion de l'appelant
  user requis	object	Champ Type Description id string email requis string name string ou null totp_enabled integer created_at integer last_login_at integer ou null recovery_left integer
  platformAdmin	boolean
  teams requis	liste de Team
  roles	liste de object	Champ Type Description id string label string

• 401 Aucun jeton d'API ou session valide
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/me" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

patch/me

Changer votre nom

Session du tableau de bord seulementupdateMe

Corps de la requête

application/json · object

Réponses

• 200 Enregistré

  application/json · Ok

  Champ	Type	Description
  ok requis	true

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X PATCH "https://api.liftpad.app/v1/me" \
  -H "content-type: application/json" \
  -d '{"name":"Sam Tremblay"}'

post/me/logout-all

Se déconnecter partout Termine toutes les sessions et annule tous vos jetons d'API.

Session du tableau de bord seulementlogoutEverywhere

Réponses

• 200 Déconnecté

  application/json · Ok

  Champ	Type	Description
  ok requis	true

• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X POST "https://api.liftpad.app/v1/me/logout-all"

get/me/tokens

Lister vos jetons d'API Noms et dates seulement; la valeur d'un jeton n'est jamais remontrée.

Jeton : read ou deploylistTokens

Réponses

• 200 Jetons

  application/json · liste de Token

• 401 Aucun jeton d'API ou session valide
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/me/tokens" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

post/me/tokens

Créer un jeton d'API Session du tableau de bord seulement (un jeton ne peut pas créer de jeton). access vaut deploy (sites, déploiements, domaines) ou read. team le limite à une équipe. days fixe l'expiration (le tableau de bord offre 90, 365 ou aucune; au plus 730). Le jeton n'apparaît que dans cette réponse.

Session du tableau de bord seulementcreateToken

Corps de la requête

application/json · object

Réponses

• 201 Créé

  application/json · object

  Champ	Type	Description
  id requis	string
  token requis	string	lp_... montré une fois
  expiresAt requis	integer ou null

• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X POST "https://api.liftpad.app/v1/me/tokens" \
  -H "content-type: application/json" \
  -d '{"name":"GitHub Actions","access":"deploy","team":"my-agency","days":90}'

delete/me/tokens/{id}

Révoquer un jeton d'API

Session du tableau de bord seulementrevokeToken

Paramètres

Réponses

• 200 Révoqué

  application/json · Ok

  Champ	Type	Description
  ok requis	true

• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X DELETE "https://api.liftpad.app/v1/me/tokens/ID"

get/teams

Lister vos équipes

Jeton : read ou deployTout rôle d'équipelistTeams

Réponses

• 200 Équipes

  application/json · liste de Team

• 401 Aucun jeton d'API ou session valide
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/teams" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

get/teams/{slug}

Obtenir une équipe Avec les membres et les invitations en attente (pour qui gère les membres).

Jeton : read ou deployTout rôle d'équipegetTeam

Paramètres

Réponses

• 200 L'équipe

  application/json · object

  Champ	Type	Description
  id	string
  slug requis	string
  name	string
  role	string: owner, admin, developer, reviewer, billing, viewer	Votre rôle dans l'équipe (pour un jeton : ce qu'il peut faire)
  caps	liste de string: view, deploy, sites, domains, members, billing, team
  scoped	boolean	Vous ne voyez que certains sites de l'équipe
  plan	Plan
  billingStatus	string ou null
  billing	object ou null
  trialEndsAt	integer ou null
  currentPeriodEnd	integer ou null
  billingEmail	string ou null
  usage	object ou null	Sites, domaines, membres et stockage utilisés
  members requis	liste de object
  invites	liste de object
  roles	liste de object

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/teams/my-agency" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

patch/teams/{slug}

Renommer une équipe ou changer son courriel de facturation name exige un propriétaire; billingEmail un propriétaire ou un membre facturation.

Session du tableau de bord seulementPropriétaireupdateTeam

Paramètres

Corps de la requête

application/json · object

Réponses

• 200 Enregistré

  application/json · Ok

  Champ	Type	Description
  ok requis	true

• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X PATCH "https://api.liftpad.app/v1/teams/my-agency" \
  -H "content-type: application/json" \
  -d '{"name":"My Agency"}'

post/teams/{slug}/invites

Inviter une personne Un lien à usage unique par courriel. sites limite un développeur, réviseur ou observateur à certains sites. Seuls les propriétaires invitent des propriétaires ou des membres facturation.

Session du tableau de bord seulementAdministrateur ou propriétaireinviteMember

Paramètres

Corps de la requête

application/json · object

Réponses

• 201 Invitée

  application/json · object

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X POST "https://api.liftpad.app/v1/teams/my-agency/invites" \
  -H "content-type: application/json" \
  -d '{"email":"client@example.com","role":"reviewer","sites":["client-site"]}'

delete/teams/{slug}/invites/{id}

Annuler une invitation

Session du tableau de bord seulementAdministrateur ou propriétairerevokeInvite

Paramètres

Réponses

• 200 Annulée

  application/json · Ok

  Champ	Type	Description
  ok requis	true

• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X DELETE "https://api.liftpad.app/v1/teams/my-agency/invites/ID"

patch/teams/{slug}/members/{userId}

Changer le rôle ou les sites d'un membre sites null retire la limite de sites. Une équipe garde toujours un propriétaire.

Session du tableau de bord seulementAdministrateur ou propriétaireupdateMember

Paramètres

Corps de la requête

application/json · object

Réponses

• 200 Enregistré

  application/json · Ok

  Champ	Type	Description
  ok requis	true

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X PATCH "https://api.liftpad.app/v1/teams/my-agency/members/USER_ID" \
  -H "content-type: application/json" \
  -d '{"role":"developer"}'

delete/teams/{slug}/members/{userId}

Retirer un membre (ou quitter) Ses jetons pour cette équipe cessent de fonctionner.

Session du tableau de bord seulementAdministrateur ou propriétaireremoveMember

Paramètres

Réponses

• 200 Retiré

  application/json · Ok

  Champ	Type	Description
  ok requis	true

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X DELETE "https://api.liftpad.app/v1/teams/my-agency/members/USER_ID"

get/plans

Lister les forfaits Prix en CAD par mois, taxes en sus. Aucune connexion requise.

Sans connexionlistPlans

Réponses

• 200 Forfaits

  application/json · liste de Plan

Exemple

curl -sS "https://api.liftpad.app/v1/plans"

get/teams/{slug}/billing

Forfait et facturation d'une équipe

Jeton : read ou deployTout rôle d'équipegetBilling

Paramètres

Réponses

• 200 Facturation

  application/json · object

  Champ	Type	Description
  id	string
  slug	string
  name	string
  role	string: owner, admin, developer, reviewer, billing, viewer	Votre rôle dans l'équipe (pour un jeton : ce qu'il peut faire)
  caps	liste de string: view, deploy, sites, domains, members, billing, team
  scoped	boolean	Vous ne voyez que certains sites de l'équipe
  plan	Plan
  billingStatus	string ou null
  billing	object ou null
  trialEndsAt	integer ou null
  currentPeriodEnd	integer ou null
  billingEmail	string ou null
  usage	object ou null	Sites, domaines, membres et stockage utilisés
  canManage	boolean
  plans requis	liste de object
  portalUrl	string ou null
  stripeLinked	boolean

• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/teams/my-agency/billing" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

get/teams/{slug}/credits

Crédits d'une équipe Solde, coûts, forfaits de crédits et les 30 derniers mouvements. Ensembles : 1000 pour 10 $, 5000 pour 45 $, 12000 pour 99 $.

Jeton : read ou deployTout rôle d'équipegetCredits

Paramètres

Réponses

• 200 Crédits

  application/json · Credits

  Champ	Type	Description
  total requis	integer
  monthly	integer	Reste des crédits mensuels du forfait
  bought	integer
  planMonthly	integer
  costs requis	table de integer	Crédits par action
  packs requis	liste de object	Champ Type Description id string credits integer priceCad number
  payments	boolean	Le paiement en ligne est ouvert
  card	object ou null
  auto	object ou null	Recharge automatique
  ledger	liste de object	Champ Type Description at integer delta integer kind string note string ou null

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/teams/my-agency/credits" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

post/teams/{slug}/credits/checkout

Acheter un ensemble de crédits Propriétaires et membres facturation. Répond avec une adresse de paiement Stripe.

Session du tableau de bord seulementPropriétaire ou facturationbuyCredits

Paramètres

Corps de la requête

application/json · object

Réponses

• 201 Paiement ouvert

  application/json · object

  Champ	Type	Description
  checkoutUrl requis	string

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)
• 502 Un service externe (Cloudflare, le registraire, Stripe) n'a pas répondu; réessayez
• 503 Pas encore offert sur ce Liftpad, ou indisponible un moment

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X POST "https://api.liftpad.app/v1/teams/my-agency/credits/checkout" \
  -H "content-type: application/json" \
  -d '{"pack":"credits_1000"}'

post/teams/{slug}/credits/auto

Recharges automatiques Achète un ensemble quand le solde passe sous un seuil, au plus 3 fois par mois. pack null les désactive.

Session du tableau de bord seulementPropriétaire ou facturationsetAutoTopup

Paramètres

Corps de la requête

application/json · object

Réponses

• 200 Enregistré

  application/json · Ok

  Champ	Type	Description
  ok requis	true

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 409 En conflit avec l'état actuel (voir error)
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X POST "https://api.liftpad.app/v1/teams/my-agency/credits/auto" \
  -H "content-type: application/json" \
  -d '{"pack":"credits_1000","below":100}'

delete/teams/{slug}/credits/card

Oublier la carte enregistrée

Session du tableau de bord seulementPropriétaire ou facturationforgetCard

Paramètres

Réponses

• 200 Retirée

  application/json · Ok

  Champ	Type	Description
  ok requis	true

• 401 Aucun jeton d'API ou session valide
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

# Session du tableau de bord seulement : un jeton d'API reçoit 403 session_required
curl -sS -X DELETE "https://api.liftpad.app/v1/teams/my-agency/credits/card"

get/audit

Journal d'activité Les 200 dernières actions de vos équipes (seulement vos sites si vous êtes limité à certains).

Jeton : read ou deployTout rôle d'équipelistAudit

Paramètres

Réponses

• 200 Entrées, de la plus récente à la plus ancienne

  application/json · liste de AuditEntry

• 401 Aucun jeton d'API ou session valide
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS "https://api.liftpad.app/v1/audit" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN"

post/abuse

Signaler un site hébergé sur Liftpad Tout le monde peut signaler de l'hameçonnage, des logiciels malveillants, des arnaques et d'autres abus. Une personne chez Liftpad lit chaque signalement. Exige l'en-tête x-liftpad-csrf et un corps JSON.

Sans connexionreportAbuse

Paramètres

Corps de la requête

application/json · object

Réponses

• 201 Reçu

  application/json · object

  Champ	Type	Description
  ok requis	boolean
  message	string

• 400 La requête n'est pas valide (voir error et message)
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 404 Introuvable, ou invisible pour vous
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS -X POST "https://api.liftpad.app/v1/abuse" \
  -H "x-liftpad-csrf: 1" \
  -H "content-type: application/json" \
  -d '{"url":"https://example.liftpad.ca/login","kind":"phishing","details":"Asks for bank passwords."}'

post/leads

Demander à être contacté par Liftpad Le formulaire de contact de liftpad.app. Exige l'en-tête x-liftpad-csrf et un corps JSON.

Sans connexionrequestContact

Paramètres

Corps de la requête

application/json · object

Réponses

• 200 Reçu

  application/json · Ok

  Champ	Type	Description
  ok requis	true

• 400 La requête n'est pas valide (voir error et message)
• 403 Non permis : rôle insuffisant, jeton utilisé là où une session du tableau de bord est requise (session_required), ou en-tête CSRF absent (csrf)
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS -X POST "https://api.liftpad.app/v1/leads" \
  -H "x-liftpad-csrf: 1" \
  -H "content-type: application/json" \
  -d '{"name":"Sam","email":"sam@example.com","sites":"4-10","lang":"en"}'

post/mcp

Serveur MCP pour les agents IA Model Context Protocol en HTTP continu, JSON-RPC 2.0 sans état (initialize, ping, tools/list, tools/call; un lot reçoit une réponse pour ses 20 premiers messages, et les messages après le 20e sont ignorés sans réponse). Jetons d'API seulement, jamais de témoin. Chaque outil appelle cette API avec votre jeton : les mêmes rôles et limites s'appliquent. Un jeton read peut utiliser list_sites, get_site, list_deploys, launch_checks, form_submissions, site_analytics et search_domains; les autres exigent un jeton deploy. Outils : list_sites, get_site, create_site, list_files, read_file, deploy_changes, launch_checks, list_deploys, publish, form_submissions, site_analytics, search_domains, connect_domain, site_agents_report.

Jeton : read ou deployTout rôle d'équipemcp

Corps de la requête

application/json · object ou liste de object

Réponses

• 200 Réponse JSON-RPC (202 sans corps pour les notifications)

  application/json · object ou liste de any

• 400 La requête n'est pas valide (voir error et message)
• 401 Aucun jeton d'API ou session valide
• 429 Trop de requêtes (error : rate_limited) ou une limite quotidienne (error : deploy_limit)

Exemple

curl -sS -X POST "https://api.liftpad.app/mcp" \
  -H "Authorization: Bearer $LIFTPAD_TOKEN" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_sites","arguments":{}}}'

get/openapi.json

Ce document OpenAPI Aussi à https://liftpad.app/openapi.json.

Sans connexiongetOpenApi

Réponses

• 200 OpenAPI 3.1

  application/json · object

Exemple

curl -sS "https://api.liftpad.app/v1/openapi.json"

postdeploy.ready

Un déploiement est terminé et son aperçu fonctionne

application/json · object

{
  "event": "deploy.ready",
  "delivery": "6f1c2a9e-0d4b-4c2e-9a77-3b1f0c2d4e5f",
  "at": "2026-11-05T15:04:05.000Z",
  "site": {
    "name": "my-site",
    "url": "https://my-site.liftpad.ca"
  },
  "deploy": {
    "id": "k2j4h6g8f0d2",
    "title": "First deploy",
    "previewUrl": "https://k2j4h6g8f0d2--my-site.liftpad.ca",
    "files": 12
  }
}

postdeploy.published

Un déploiement est en ligne (aussi après un retour arrière)

application/json · object

{
  "event": "deploy.published",
  "delivery": "0a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
  "at": "2026-11-05T15:05:00.000Z",
  "site": {
    "name": "my-site",
    "url": "https://www.example.com"
  },
  "deploy": {
    "id": "k2j4h6g8f0d2",
    "title": "First deploy"
  }
}

postform.submission

Un visiteur a envoyé un formulaire (les indésirables ne sont pas transmis)

application/json · object

{
  "event": "form.submission",
  "delivery": "9e8d7c6b-5a4f-4e3d-9c2b-1a0f9e8d7c6b",
  "at": "2026-11-05T15:06:00.000Z",
  "site": {
    "name": "my-site",
    "url": "https://my-site.liftpad.ca"
  },
  "submission": {
    "id": "sub_abc123",
    "form": "contact",
    "data": {
      "name": "Sam",
      "message": "Hello"
    },
    "files": [],
    "preview": false,
    "createdAt": 1793977560000
  }
}

posttest

Envoyé par le bouton d'essai (testHook)

application/json · object

{
  "event": "test",
  "delivery": "1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e",
  "at": "2026-11-05T15:07:00.000Z",
  "site": {
    "name": "my-site",
    "url": "https://my-site.liftpad.ca"
  }
}