Permissions des clés API

Chaque clé porte une liste de permissions choisies à sa création (page Clés API de l'espace client). Une clé peut aussi être restreinte à certains services et à certaines adresses IP. Les permissions marquées sensible peuvent modifier ou effacer des données : ne les donnez à un assistant IA qu'en connaissance de cause.

Page générée

Cette page est générée automatiquement depuis la table des routes de l'API. Ne la modifiez pas à la main.

Permission	Ce qu'elle autorise	Routes	Outils MCP
account:read	Lire le profil du compte	GET /client/v1/account	get_account
services:read	Lister les services	GET /client/v1/services GET /client/v1/services/{id} GET /client/v1/catalog	list_services, get_service, list_products
billing:read	Lire factures et crédit	GET /client/v1/invoices GET /client/v1/invoices/{id} GET /client/v1/invoices/{id}/pdf GET /client/v1/invoices/{id}/payment-link	list_invoices, get_invoice, get_payment_link
tickets:read	Lire les tickets	GET /client/v1/tickets GET /client/v1/tickets/{id} GET /client/v1/ticket-departments	list_tickets, get_ticket
tickets:write	Ouvrir et répondre aux tickets	POST /client/v1/tickets POST /client/v1/tickets/{id}/reply	create_ticket, reply_ticket
vps:read	État et métriques des VPS	GET /client/v1/vps/{id} GET /client/v1/vps/{id}/metrics	get_vps, get_vps_metrics
vps:power	Démarrer / arrêter / redémarrer les VPS	POST /client/v1/vps/{id}/power	vps_power
vps:manage	Hostname, clés SSH, mot de passe root (sensible)	à venir	—
vps:reinstall	Réinstaller un VPS (efface les données) (sensible)	à venir	—
game:read	État et métriques des serveurs de jeu	GET /client/v1/game-servers/{id} GET /client/v1/game-servers/{id}/metrics	get_game_server, get_game_server_metrics
game:power	Démarrer / arrêter / redémarrer les serveurs de jeu	POST /client/v1/game-servers/{id}/power	game_server_power
game:console	Lire la console et envoyer des commandes	à venir	—
game:files:read	Lire les fichiers des serveurs de jeu	à venir	—
game:manage	Variables, bases de données, ports (sensible)	à venir	—
game:reinstall	Réinstaller un serveur de jeu (efface les données) (sensible)	à venir	—
dns:read	Lire les domaines et zones DNS	GET /client/v1/dns/domains GET /client/v1/dns/domains/{domain} GET /client/v1/dns/domains/{domain}/records GET /client/v1/dns/domains/{domain}/export GET /client/v1/dns/domains/{domain}/dnssec GET /client/v1/dns/domains/{domain}/presets	dns_list_domains, dns_get_domain, dns_list_records, dns_export_zone
dns:write	Modifier les enregistrements DNS	POST /client/v1/dns/domains/{domain}/records PATCH /client/v1/dns/domains/{domain}/records/{record_id} DELETE /client/v1/dns/domains/{domain}/records/{record_id} POST /client/v1/dns/domains/{domain}/zone POST /client/v1/dns/domains/{domain}/import PUT /client/v1/dns/domains/{domain}/dnssec POST /client/v1/dns/domains/{domain}/presets/{preset}	dns_add_record, dns_update_record, dns_delete_record
rdns:read	Lire le reverse DNS (PTR) des IP	GET /client/v1/rdns	rdns_list
rdns:write	Modifier le reverse DNS (PTR) des IP	PUT /client/v1/rdns/{ip} DELETE /client/v1/rdns/{ip} POST /client/v1/rdns/bulk	rdns_set, rdns_reset, rdns_bulk
antiddos:read	Historique des attaques DDoS	GET /client/v1/antiddos GET /client/v1/antiddos/rules	get_ddos_attacks, list_ddos_rules
antiddos:write	Créer des règles anti-DDoS, ouvrir l'UDP 53 d'un DNS faisant autorité (sensible)	POST /client/v1/antiddos/rules POST /client/v1/antiddos/rules/{id}/move DELETE /client/v1/antiddos/rules/{id} POST /client/v1/antiddos/rules/dns-authoritative	create_ddos_rule, move_ddos_rule, delete_ddos_rule, enable_authoritative_dns
orders:write	Commander des services (prix confirmé, plafond quotidien)	POST /client/v1/orders POST /client/v1/sandboxes/{id}/keep POST /client/v1/sandboxes/claim	create_order, keep_sandbox, claim_sandbox
sandbox:read	Voir ses sandboxes, clés SSH et noms des secrets	GET /client/v1/sandboxes GET /client/v1/sandboxes/{id} GET /client/v1/sandboxes/{id}/files GET /client/v1/sandboxes/{id}/files/content GET /client/v1/sandbox-keys GET /client/v1/sandbox-secrets	list_sandboxes, sandbox_list_files, sandbox_read_file, list_sandbox_keys, list_sandbox_secrets
sandbox:write	Créer, utiliser et supprimer des sandboxes ; clés SSH et secrets	POST /client/v1/sandboxes DELETE /client/v1/sandboxes/{id} POST /client/v1/sandboxes/{id}/links POST /client/v1/sandboxes/{id}/exec PUT /client/v1/sandboxes/{id}/files/content POST /client/v1/sandbox-keys DELETE /client/v1/sandbox-keys PUT /client/v1/sandbox-secrets/{name} DELETE /client/v1/sandbox-secrets/{name}	create_sandbox, sandbox_links, delete_sandbox, sandbox_exec, sandbox_write_file, add_sandbox_key, remove_sandbox_key, set_sandbox_secret, delete_sandbox_secret

Modèles proposés à la création

• Lecture seule : toutes les permissions *:read.
• Monitoring + redémarrage : lecture + vps:power, game:power, game:console.
• Agent IA (sans action destructive) : le modèle précédent + tickets:write, game:files:read, dns:write, rdns:write, sandbox:read, sandbox:write.

Les permissions dns:* portent sur les domaines du compte : la restriction d'une clé à certains services ne s'y applique pas (un domaine n'est pas un service). Les permissions rdns:* portent sur les IP des services, et respectent cette restriction.

Aucun modèle n'inclut de permission sensible : elles se cochent explicitement.