Agent-Native

AI Agent Hosting API

Provision websites, manage DNS, deploy code, and change plans — all via REST API, MCP server, or Stripe ACP.

Interactive API Explorer Quick Start API Reference

What your agent can do

155 tools covering the complete lifecycle of your hosting. Your AI assistant manages everything — you supervise.

Hosting

Purchase, provision, scale

Deployment

Deploy, rollback

DNS

A, CNAME, MX, TXT, SRV

Files

Read, write, upload

Snapshots

Local, B2 cloud, scheduled

Backups

Auto, manual, restore

Domains

Search, register, DNS

SSH

Connection, SSH keys

AI Modules

Chatbot, SEO, translation

Security

Per-site keys, permissions

Three Ways to Integrate

REST API

Standard JSON endpoints with Bearer token authentication. Works with any language.

https://borealhost.ai/api/v1/

MCP Server

Model Context Protocol server for Claude, ChatGPT, and other AI assistants. 155 tools available.

https://borealhost.ai/mcp/

Stripe ACP

Agent Checkout Protocol for automated payments. Agents can purchase directly.

/.well-known/acp.json

Quick Start — Agent Self-Service

1. Découvrir les forfaits

curl https://borealhost.ai/api/v1/plans/

2. Créer un checkout

curl -X POST https://borealhost.ai/api/v1/acp/checkouts/ \
  -H "Authorization: Bearer bh_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sku": "bh_site_starter_monthly"}'

3. Définir les infos acheteur

curl -X POST https://borealhost.ai/api/v1/acp/checkouts/CHECKOUT_ID/update/ \
  -H "Content-Type: application/json" \
  -d '{"buyer_email": "[email protected]", "requested_slug": "my-site"}'

4. Payer et provisionner

Returns a Stripe URL for payment. The site is provisioned automatically after payment.

curl -X POST https://borealhost.ai/api/v1/acp/checkouts/CHECKOUT_ID/complete/ \
  -H "Content-Type: application/json" \
  -d '{"payment_method": "stripe_checkout"}'

5. Vérifier le statut et récupérer la clé API

After payment, poll this endpoint. The response includes your API key and site info.

curl https://borealhost.ai/api/v1/acp/checkouts/CHECKOUT_ID/

6. Gérer votre site

curl -H "Authorization: Bearer bh_YOUR_KEY" \
  https://borealhost.ai/api/v1/sites/my-site/

Endpoint Reference

Authentification

GET /api/v1/auth/whoami/ Verify API key and account

Discovery (no auth required)

GET /api/v1/plans/ List plans

GET /api/v1/plans/{slug}/ Plan details

GET /api/v1/status/ Platform status

Sites (authenticated)

POST /api/v1/sites/create/ Provision a site

GET /api/v1/sites/ List my sites

GET /api/v1/sites/{slug}/ Site details

POST /api/v1/sites/{slug}/dns/ Manage DNS

POST /api/v1/sites/{slug}/deploy/ Trigger deployment

POST /api/v1/sites/{slug}/snapshot/ Create snapshot

GET /api/v1/sites/{slug}/metrics/ Traffic metrics

POST /api/v1/sites/{slug}/scale/ Change plan

DELETE /api/v1/sites/{slug}/delete/ Delete site

File Management (authenticated)

GET /api/v1/sites/{slug}/files/ List directory contents

GET /api/v1/sites/{slug}/files/read/ Read a file

POST /api/v1/sites/{slug}/files/write/ Write a file

POST /api/v1/sites/{slug}/files/upload/ Upload a file (base64)

POST /api/v1/sites/{slug}/files/mkdir/ Create a directory

POST /api/v1/sites/{slug}/files/delete/ Delete a file

SSH Access (authenticated, VPS only)

GET /api/v1/sites/{slug}/ssh/ SSH connection info

POST /api/v1/sites/{slug}/ssh/keys/ Inject an SSH public key

Logs (authenticated)

GET /api/v1/sites/{slug}/logs/ View container logs

AI Modules (authenticated)

GET /api/v1/sites/{slug}/modules/ List modules

POST /api/v1/sites/{slug}/modules/{name}/toggle/ Enable/disable a module

Domain Management (authenticated)

GET /api/v1/domains/ List my domains

GET /api/v1/domains/search/ Check domain availability

POST /api/v1/domains/register/ Register a domain

GET /api/v1/domains/{name}/ Domain details

GET /api/v1/domains/{name}/dns/ List DNS records

POST /api/v1/domains/{name}/dns/add/ Add a DNS record

POST /api/v1/domains/{name}/dns/delete/ Delete a DNS record

POST /api/v1/domains/{name}/link/ Link a domain to a site

POST /api/v1/domains/{name}/settings/ Domain settings

ACP Checkout (no auth required)

POST /api/v1/acp/checkouts/ Create checkout session

GET /api/v1/acp/checkouts/{id}/ Checkout status

POST /api/v1/acp/checkouts/{id}/update/ Buyer info

POST /api/v1/acp/checkouts/{id}/complete/ Pay and provision

API Keys

POST /api/v1/keys/create/ Create key

GET /api/v1/keys/ List my keys

POST /api/v1/keys/{id}/rotate/ Rotate key

Account Management

POST /api/v1/account/update/ Update profile

DELETE /api/v1/account/delete/ Delete account

GET /api/v1/account/subscriptions/ List subscriptions

GET /api/v1/account/billing-portal/ Stripe billing portal

View complete reference (llms-full.txt) →