Geta.Team Geta.Team
API

Gérer vos espaces

Tout ce que vous faites dans votre dashboard, depuis votre propre backend.

Avec la même clé, votre backend atteint chaque page de votre dashboard : vos espaces, leur serveur, le réseau, les sauvegardes, les factures et les tickets de support. Chaque appel ne porte que sur votre compte ; l’espace d’un autre compte répond 404.

Ces appels se trouvent à côté de /v1, sous la même URL de base, https://dash.geta.team/api. Une réponse réussie porte "success": true ; un refus de l’appel lui-même est { "success": false, "error": "un message lisible" }, tandis qu’un refus du contrôle de la clé garde son code (Erreurs).

curl https://dash.geta.team/api/saas-byok/instances \
  -H "Authorization: Bearer gat_sk_..."

Une clé en lecture seule fait les appels GET ; tous les autres demandent une clé en lecture et écriture. Champs, réponses et erreurs de chaque appel : la référence interactive.

Espaces

AppelCe qu’il fait
GET /saas-byok/instancesVos espaces, puis ceux supprimés que vous pouvez encore restaurer
GET /saas-byok/instances/{id}/detailsUn espace
POST /saas-byok/instances/{id}/credentialsSon adresse, l’email administrateur et le mot de passe
GET /saas-byok/pricingFormules et prix
PUT /saas-byok/instances/{id}/planChanger de formule, { "employees": 3 } : à la hausse tout de suite (au prorata), à la baisse au prochain renouvellement
POST /saas-byok/instances/{id}/cancelRésilier l’abonnement à la fin de la période payée
POST /saas-byok/instances/{id}/resumeLe garder finalement
DELETE /saas-byok/instances/{id}Supprimer l’espace

Serveur

AppelCe qu’il fait
POST /saas-byok/instances/{id}/restartRedémarrer l’application (rapide, sans risque)
POST /saas-byok/instances/{id}/updateInstaller la dernière version, puis redémarrer
POST /saas-byok/instances/{id}/resetRéinitialiser le serveur
POST /saas-byok/instances/{id}/power-offÉteindre (toujours facturé)
POST /saas-byok/instances/{id}/power-onAllumer
POST /saas-byok/instances/{id}/redeployRedemander le serveur, pour un espace en erreur

Réseau et SSH

AppelCe qu’il fait
GET, POST /saas-byok/instances/{id}/firewallLire, ou remplacer, les règles du pare-feu
POST /saas-byok/instances/{id}/firewall/enable, /disableActiver ou désactiver le pare-feu
GET, POST /saas-byok/instances/{id}/domainsLister, ou ajouter, des domaines personnalisés
POST /saas-byok/instances/{id}/domains/removeRetirer un domaine personnalisé
GET, POST /saas-byok/instances/{id}/ptrLire, ou définir, le DNS inverse
GET, POST /saas-byok/instances/{id}/ssh-keysLister, ou ajouter, des clés SSH
DELETE /saas-byok/instances/{id}/ssh-keys/{name}Retirer une clé SSH

Sauvegardes

AppelCe qu’il fait
GET /saas-byok/instances/{id}/backupsLes sauvegardes quotidiennes, de la plus récente à la plus ancienne
POST /saas-byok/instances/{id}/backupsSauvegarder maintenant
POST /saas-byok/instances/{id}/backups/restoreEn restaurer une (remplace les données actuelles)

Facturation et support

AppelCe qu’il fait
GET /saas/invoicesVos factures, avec leur PDF
GET /saas/upcoming-invoicesCe que chaque espace paiera à son renouvellement
GET, POST /saas/support/ticketsVos tickets, ou en ouvrir un
GET /saas/support/tickets/{ticketId}Un ticket et ses réponses
POST /saas/support/tickets/{ticketId}/repliesRépondre
POST /saas/support/tickets/{ticketId}/resolveLe clore

Ce qui reste dans le dashboard

Pour votre sécurité, une clé n’atteint jamais : la connexion et la double authentification, les clés API et le webhook eux-mêmes, l’email du compte et la fermeture du compte. Ces routes répondent 403 not_available_with_api_key.

On this page