Passer au contenu principal
GET
Consulter les crédits
Cet endpoint nécessite une clé API de gestion. Les clés API standard du Gateway ne sont pas acceptées.

Ajouter des crédits depuis la CLI ou l’API

Les agents et les scripts peuvent lancer une recharge avec POST /v1/credits/topups ou la CLI. Une personne approuve toujours le débit.
  • Le jeton doit avoir le scope billing:write. Il n’est jamais accordé par défaut : ajoutez-le avec phaseo login --scopes billing:write, ou indiquez-le sur une clé de gestion.
  • Les recharges depuis l’API ou la CLI vont de $5 à $500 ; les recharges plus importantes se font dans le tableau de bord. Un espace de travail peut en avoir 5 en attente à la fois (une sixième renvoie 429 too_many_pending_topups), et chacune expire au bout de 30 minutes.
  • Pas encore de carte enregistrée : la réponse contient un checkout_url. Un propriétaire ou un administrateur de l’espace de travail l’ouvre et paie avec une nouvelle carte, qui est enregistrée pour les recharges suivantes.
  • Carte enregistrée : chaque propriétaire et administrateur reçoit un e-mail avec un lien à usage unique. L’un d’eux l’ouvre, se connecte et choisit Confirmer ou Refuser. La confirmation débite la carte, avec une vérification bancaire si la banque la demande.
  • Interrogez GET /v1/credits/topups/{id} (ou phaseo credits topups get <id>) jusqu’à ce que final soit true. Les crédits sont ajoutés quand l’état est paid. declined, expired et failed sont accompagnés d’un code reason : ne les relancez pas automatiquement ; demandez plutôt à une personne.

Autorisations

Authorization
string
header
requis

Authentification par jeton Bearer

Paramètres de requête

workspace_id
string<uuid>

Remplacement facultatif de l’espace de travail. Il doit correspondre à l’espace authentifié, sauf si l’appelant est un contrôleur interne.

Réponse

Informations sur les crédits

ok
enum<boolean>
requis
Options disponibles:
true
credits
object
requis
Dernière modification le 16 novembre 2026