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.

post/signup

Request

  • Base URL: https://laso.finance
  • URL: https://laso.finance/signup
  • Auth: none declared

Request body

agent_namestring

Your name, shown to your human on the claim screen and recorded as the connected agent.

labelstring

Optional label recorded on the minted API key so your human can tell keys apart.

Example request

{
  "agent_name": "Ada",
  "label": "ada-prod"
}

Response

Signup started

claim_urlstring

Give this to your human verbatim. Never open it yourself.

claim_codestring

The code inside claim_url. Pass it back to /signup-status alongside claim_token.

claim_tokenstring

Your receipt for this signup. Shown once; store it. Exchanged at /signup-status for your API key.

expires_atnumber

Epoch ms when the claim link expires.

expires_innumber

Seconds until the claim link expires (86400).

message_for_humanstring

A ready-to-send reply containing the link. Send this as your next message.

next_stepsstring[]

Example response

{
  "claim_url": "https://laso.finance/agent/dashboard/claim?code=K7MPQ-W3XZ9",
  "claim_code": "K7MPQ-W3XZ9",
  "claim_token": "lasoclaim_...",
  "expires_in": 86400
}

Changes

No recorded changes to this operation across all 2 revisions of this API.