API für KI-Agenten

Ihr Agent erstellt
Websites in Sekunden

Ein API-Aufruf. Ihr KI-Agent erhält eine Live-URL zurück. Veröffentlichen Sie Figma-Designs, teilen Sie Dokumente oder deployen Sie statische Seiten — programmatisch, ohne menschliches Eingreifen.

agent.py
# Your AI agent creates a live website
response = requests.post("https://api.hiro.host/api/v1/external/projects",
    headers={"X-API-Key": API_KEY},
    json={"mode": "figma", "figmaUrl": url})

# → { "url": "https://my-design.hirohost.site" }

So funktioniert es

Drei Schritte. Null Reibung.

01

Holen Sie sich Ihren API-Schlüssel

Holen Sie sich den API-Schlüssel Ihres Arbeitsbereichs von der Organisationseinstellungsseite. Ein Schlüssel pro Arbeitsbereich.

02

Agent ruft die API auf

POST an /external/projects mit einem Modus (figma, viewer oder static) und optionaler Konfiguration. Eine Subdomain wird automatisch generiert, wenn Sie sie weglassen.

03

Erhalten Sie eine Live-URL zurück

Die Antwort enthält eine Live-URL, die Ihr Agent teilen, einbetten oder an den Benutzer weitergeben kann. Aktualisieren Sie das Projekt jederzeit über PATCH.

API-Beispiele

Jeder Projekttyp, ein Endpoint.

Figma-Einbettungen, Dokumenten-Viewer, statische Websites — alle über dieselbe POST-Anfrage erstellt. Ihr Agent wählt den Modus.

Publish a Figma designpython
import requests

resp = requests.post(
    "https://api.hiro.host/api/v1/external/projects",
    headers={"X-API-Key": API_KEY},
    json={
        "mode": "figma",
        "figmaUrl": "https://www.figma.com/design/abc/My-Design",
    },
)
print(resp.json()["url"])
# → https://cedar-drift-bloom.hirohost.site
Create a document sitepython
resp = requests.post(
    "https://api.hiro.host/api/v1/external/projects",
    headers={"X-API-Key": API_KEY},
    json={
        "mode": "viewer",
        "subdomain": "quarterly-report",
    },
)
# Upload files to the project separately
print(resp.json()["url"])
# → https://quarterly-report.hirohost.site
Deploy a static sitepython
resp = requests.post(
    "https://api.hiro.host/api/v1/external/projects",
    headers={"X-API-Key": API_KEY},
    json={
        "mode": "static",
        "subdomain": "docs-preview",
        "spaFallback": True,
    },
)
# Upload ZIP/HTML to the project separately
print(resp.json()["url"])
# → https://docs-preview.hirohost.site
Update a projectpython
requests.patch(
    f"https://api.hiro.host/api/v1/external/projects/{uid}",
    headers={"X-API-Key": API_KEY},
    json={
        "password": "secret123",
        "isActive": True,
        "locale": "fr",
    },
)

Claude Code Skill

Ein Klick zum Beibringen
für Ihren Agenten.

Kopieren Sie den Skill unten und speichern Sie ihn als SKILL.md-Datei. Ihr Claude Code Agent wird wissen, wie er HIRO host Websites automatisch erstellen und verwalten kann.

1

Erstellen Sie ~/.claude/skills/hiro-publish/

2

Fügen Sie den kopierten Inhalt in SKILL.md ein

3

Verwenden Sie /hiro-publish in Claude Code oder lassen Sie es automatisch aktivieren

~/.claude/skills/hiro-publish/SKILL.md
---
name: hiro-publish
description: >-
  Create and manage websites on HIRO host via API.
  Use when the user wants to publish a Figma design, share a document,
  or deploy a static site to a live URL.
allowed-tools: Bash(curl *)
---

# HIRO host — Publish to web

You can create and manage live websites using the HIRO host API.

## Setup

The user must provide their API key. Ask for it if not provided.
Set it as a variable for the session:

```bash
export HIRO_API_KEY="<the user's API key>"
```

## Base URL

```
https://api.hiro.host/api/v1/external/projects
```

## Create a project

POST to the base URL. Supported modes: `figma`, `viewer`, `static`.

**Figma design:**
```bash
curl -s -X POST "$HIRO_BASE/api/v1/external/projects" \
  -H "X-API-Key: $HIRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "figma", "figmaUrl": "<figma_url>"}'
```

**Document (viewer):**
```bash
curl -s -X POST "$HIRO_BASE/api/v1/external/projects" \
  -H "X-API-Key: $HIRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "viewer", "subdomain": "<optional-name>"}'
```

**Static website:**
```bash
curl -s -X POST "$HIRO_BASE/api/v1/external/projects" \
  -H "X-API-Key: $HIRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "static", "subdomain": "<optional-name>", "spaFallback": true}'
```

Omit `subdomain` to auto-generate a random one (e.g. cedar-drift-bloom).

## Update a project

PATCH with the project UID:

```bash
curl -s -X PATCH "$HIRO_BASE/api/v1/external/projects/<project_uid>" \
  -H "X-API-Key: $HIRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"isActive": false, "password": "secret"}'
```

## Available fields

Create: `mode`, `subdomain`, `figmaUrl`, `isActive`, `locale`, `password`,
`emailCollectionEnabled`, `downloadsDisabled`, `spaFallback`, `actionMenu`.

Update: all of the above except `mode` and `subdomain`, plus `removePassword`.

## Response

Both endpoints return:
```json
{
  "uid": "...",
  "url": "https://<subdomain>.hirohost.site",
  "host": "...",
  "mode": "...",
  "isActive": true,
  ...
}
```

Always show the user the `url` from the response so they can visit their site.

Bereit zu automatisieren?

Registrieren Sie sich, holen Sie sich Ihren API-Schlüssel aus den Organisationseinstellungen und lassen Sie Ihre Agenten mit dem Veröffentlichen beginnen.

Kostenlos startenZu den Einstellungen