Zum Inhalt springen
Browserberg Browserberg

Browserberg-API-Referenz

Jeder v1-Endpunkt in einem Bereich: Sessions, Verben, Aufgaben, Workflows, Trigger, Zugangsdaten, Pools, das Audit-Log, Fehlercodes und harte Limits.

So nutzt du diese Referenz

Jede Seite hier behandelt eine Ressourcenfamilie vollständig: die Endpunkte, die Request-Bodies Feld für Feld und die Response-Felder, auf die sich Verzweigen lohnt. Bist du neu, ist der Schnellstart die schnellere erste Stunde; komm zurück, wenn du exakte Formen brauchst. Scheitern teilt sich einen einzigen Umschlag über alle Endpunkte — siehe Fehler und Wiederholungen — und die erzwungenen Zahlen stehen in Limits.

Alle Seiten in diesem Abschnitt

  1. 1

    Sessions-API-Referenz

    Browser-Sessions per HTTP anlegen, abfragen, verlängern und freigeben: der volle Create-Body, die zwei Keep-alive-Kappungen und jedes Feld des Session-Datensatzes.

  2. 2

    Session-Verben-API-Referenz

    Request- und Response-Formen der drei Verb-Endpunkte einer Session: observe-Kandidaten, act-Schritte samt withheld-Verweigerungen und extract-Schemas.

  3. 3

    Aufgaben-API-Referenz

    Starte einen gehosteten Agentenlauf in einer Session und polle ihn bis zum Endzustand: Anfrageoptionen, TaskRun-Felder und das separate Reviewer-Urteil.

  4. 4

    Workflows-API-Referenz

    Unveränderliche Workflow-Versionen veröffentlichen, Läufe starten und abbrechen, Block-Ergebnisse lesen und Heilungsvorschläge über die API verwalten.

  5. 5

    Trigger-API-Referenz

    Zeitplan- und Webhook-Trigger-Endpunkte: die Bodies beider Arten, Secret-Rotation, das Firings-Log und der signierte öffentliche Zustell-Endpunkt.

  6. 6

    Zugangsdaten-API-Referenz

    Portal-Logins über drei Endpunkte im Tresor verwalten: Anlegen mit Freigabe-Scope, Auflisten nur der Feldnamen, Widerrufen — Auslesen gibt es nicht.

  7. 7

    Pools-API-Referenz

    Reservierte Browser-Pools über die API verwalten: Anlegen mit Gesamtgröße, warm- und inUse-Zähler lesen, Größe per PATCH ändern, sauber löschen.

  8. 8

    Audit-Log-API-Referenz

    Das hash-verkettete Aktionslog lesen, versiegeln, exportieren und prüfen: Eintragsfelder, das kind-Vokabular und das Export-Bündel für deinen Verifizierer.

  9. 9

    Fehler und Wiederholungen: die Referenz

    Ein Fehlerumschlag auf jedem Endpunkt: jeder Code mit HTTP-Status und retryable-Flag, wie die SDKs zurückweichen und was 410 und 426 bedeuten.

  10. 10

    Limits-Referenz: jede erzwungene Zahl

    Jedes numerische Limit in einer Tabelle: Session-Längen je Tarif, ttlSeconds-Grenzen, act-Timeouts, Workflow-Größen und Webhook-Zustellraten.

  11. 11

    Usage-API-Referenz

    GET /v1/usage: gemessener Verbrauch über ein Fenster als Summen und UTC-Tageseimer, laufende Sessions und das enthaltene Kontingent. Nur lesend, ein Schreiber.

  12. 12

    Artefakte-API-Referenz

    GET /v1/artifacts/*: die Bytes hinter dem screenshotKey eines Workflow-Blocks, auf die Organisation geprüft, mit Content-Type und Digest, bis die Aufbewahrung endet.

  13. 13

    OAuth-API-Referenz

    Die OAuth-2.1-Endpunkte der Control Plane für MCP-Connectors: Discovery, dynamische Registrierung, Autorisierung, Token-Tausch mit PKCE, Refresh und Widerruf.

  14. 14

    Seitenberichte-API-Referenz

    Request- und Response-Formen der fünf inferenzfreien Berichts-Endpunkte einer Session: Consent, Agentensicht, Ziele, Kündigung und Screenshot.