Passer au contenu principal
POST
Créer un site

Autorisations

x-api-key
string
header
requis

Clé API d’authentification. Créez-en une ici.

Corps

application/json

Corps de création d’un nouveau site

url
string<uri>
requis

URL du site à créer. Protocole http/https et barres finales retirés automatiquement. Les e-mails et URL avec utilisateur (name@example.com) sont refusés avec 400.

Maximum string length: 2048
Exemple:

"https://example.com"

external_id
string

Partenaires uniquement. Un identifiant de votre propre système à associer à ce site Athena. Accepté uniquement avec une clé API d’une organisation marquée comme partenaire. L’envoi de ce champ par un client direct renvoie 403 Forbidden. Doit être unique par type de ressource dans votre organisation — les doublons renvoient 409 avec la ressource existante dans la charge utile.

Minimum string length: 1
Exemple:

"ws_a7f3b2c9"

Réponse

Site créé avec succès. externalId présent pour les partenaires (chaîne ou null), entièrement omis pour les clients directs.

website
object
requis

Une ressource de site web nouvellement créée

billingEntityCreated
boolean
requis

Indique si l’entité de facturation existe après provisionnement. Si faux, sa création a échoué même après une nouvelle tentative : le site existe mais n’a pas de crédits, et leur définition échoue avec un statut 400 jusqu’à réparation. Contactez alors l’assistance AthenaHQ.