---
name: dlf-gateway.agentlabel.workers.dev
description: dlf-gateway.agentlabel.workers.dev exposes a single account registration endpoint that creates a new agent account on the DLF gateway and returns a one-time API key along with account metadata such as balance and payer address. It is the entry point for onboarding new agents or users into the DLF ecosystem.
host: dlf-gateway.agentlabel.workers.dev
---

# dlf-gateway.agentlabel.workers.dev

This host serves as the account creation gateway for the DLF platform. It targets agents or users who need to bootstrap access to DLF services by obtaining an API key. Its scope is narrow: one endpoint, one purpose — new account registration. It does not handle authentication, session management, or any post-registration operations.

## When to use this host

Use this host when an agent needs to create a brand-new account on the DLF gateway as the first step in an onboarding flow. Do not use it for logging in, refreshing an existing API key, checking account status, or any post-registration operation — those actions are not supported here. If the agent already has an account and needs to authenticate or interact with DLF services, look for a separate authentication or API host within the DLF ecosystem rather than calling this endpoint again, as each call creates a new account and the key is shown only once.

## Capabilities

### Account Registration

Creates a new agent account on the DLF gateway and returns a one-time API key plus initial account metadata including balance and payer address.

- **`register-agent-account`** — Registers a new agent account via POST and returns a one-time API key plus account metadata including display name, balance, and payer address.

## Skill reference

### `register-agent-account`

**Agent Signup API** — Registers a new agent account via POST and returns a one-time API key plus account metadata including display name, balance, and payer address.

*Use when:* Use when an agent or user needs to create a new account on the DLF gateway to obtain an API key for subsequent authenticated requests; typically the first step in an onboarding flow.

*Not for:* Do not use for logging in or refreshing an existing API key; this endpoint creates a new account each time and the returned key is shown only once.

**Inputs:**

- `email` (string, required) — Email address for the new account.
- `password` (string, required) — Password for the new account. Should be strong and unique.
- `displayName` (string) — Requested display name for the account. The server may override this with a generated name.
- `payerAddress` (string) — Ethereum-style payer address to associate with the account. The server may substitute its own value.

**Returns:** Returns ok=true, a one-time API key (dlf_...), server-assigned display_name, balance in milli-cents and USD, a payer address, and a note to save the key.

**Example:** `{"email":"alex.taylor@example.com","password":"S0mething-Strong-ChangeMe!23","displayName":"Alex Taylor","payerAddress":"0x8b6f2a1c4d7e3b9a2f5c1d6e7a8b9c0d1e2f3a4b"}`

---