Skip to content
wabe Disk

Actor quickstart

Wabe routes requests to named actor instances at an HTTPS endpoint you run. Choose a disk and instance at invocation time.

Create a project API key in the Dashboard. Deploy a handler that accepts the broker WebSocket protocol and serves an HTTP route such as /health. Set the same endpoint secret on the handler and in the registration.

1. Register the endpoint

Section titled “1. Register the endpoint”
Terminal window
curl --fail-with-body "https://api.wabe.sh/v1/actor" \
  -H "Authorization: Bearer YOUR_PROJECT_API_KEY" \
  --json '{"name":"rooms","endpoint":"https://your-worker.example/wabe","endpointSecret":"YOUR_ENDPOINT_SECRET"}'

Replace the example URL and secret. The response returns the actor ID and fetchUrlTemplate.

2. Call an instance

Section titled “2. Call an instance”
Terminal window
curl --fail-with-body "https://api.wabe.sh/v1/actor/rooms/disks/demo/instances/room-42/fetch/health" \
  -H "Authorization: Bearer YOUR_PROJECT_API_KEY"

Wabe creates the demo disk if needed and forwards GET /health to room-42 on that disk. Run the request from your server, where you keep the project key.

See the Actor HTTP API, transport protocol and room example.