Skip to main content
public preview

These docs are a public preview. The endpoint reference is still firming up as the API host is finalized.

Legba API Documentation

Spawn disposable browser instances over a REST API. Create, list, destroy.

Introduction

Create and manage isolated browser instances for your organization. Each instance is a secure, ephemeral environment. Web-based threats never touch your infrastructure.

These docs cover every endpoint, authentication, and common integration patterns.

Base URL

Send all requests to the organization-specific host Legba provisions for your deployment:

https://{your-api-host}/orgs/{org_uuid}/api

Replace your-api-host with the host Legba assigned to your organization and org_uuid with your organization's unique identifier.

API Version

Current version: v1.0.0

Getting Started

Three steps. Then you are live:

Obtain Your API Key

Contact your Legba administrator or generate a key in your organization's dashboard.

Authenticate Your Requests

Pass your API key in the Authorization header of every request. See the Authentication guide for details.

Make Your First Request

List available images or create your first instance. The Quickstart Guide walks through both.

API Capabilities

The Legba API covers four surfaces:

Instances Management

Create, list, and destroy isolated browser instances programmatically.

Image Selection

Choose from available operating system and browser configurations.

API Key Management

Inspect your API keys. Rotate them on demand.

Audit Logging

Retrieve audit logs for compliance and monitoring.

Support & Resources

Need help? Start here: