start_signup
Start a signup for a human with no Laso account
Begins account creation for a human who does not have a Laso account yet. Requires no authentication, because the caller has no account.
This does not create the account. An agent cannot: the account is created in the human's own browser when they sign in, so it belongs to them and not to their agent. What this returns is a claim_url to hand over.
Give your human the claim_url verbatim in your very next reply (send message_for_human if unsure what to say), and do not open it yourself. Then poll GET /signup-status, which holds the connection open until they finish and hands you your lasoak_ API key.
Rate limited per IP.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | No | Optional label recorded on the minted API key so your human can tell keys apart. | |
| agent_name | No | Your name, shown to your human on the claim screen and recorded as the connected agent. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| claim_url | No | Give this to your human verbatim. Never open it yourself. | |
| claim_code | No | The code inside claim_url. Pass it back to /signup-status alongside claim_token. | |
| expires_at | No | Epoch ms when the claim link expires. | |
| expires_in | No | Seconds until the claim link expires (86400). | |
| next_steps | No | ||
| claim_token | No | Your receipt for this signup. Shown once; store it. Exchanged at /signup-status for your API key. | |
| agent_terms_url | No | The Agent Terms your human accepts by finishing the claim link, as plain text. You act for them under these terms. | |
| message_for_human | No | A ready-to-send reply containing the link. Send this as your next message. |