Start a signup
Send a verification email so a person can create a Datalyr account. This is the entry point for an agent that has no key yet, because no workspace exists for it to have a key on.
What this creates: nothing. No account row is written when you call this. The verification link carries a short-lived token; the account is created when the recipient opens it, in their browser, already verified. Abandoning the link leaves nothing behind.
What happens next is a human’s job. The link lands the person on the new-workspace form, prefilled with the workspace_name and primary_domain you sent. They pick a plan and pay through an Autumn-hosted Stripe checkout. The workspace row is created only when that payment settles. There is no way to skip this step, no trial flag, and no endpoint that mints a workspace or an API key without it.
Sending it twice. Each call sends another email and spends from both rate-limit buckets. Retry only on 503; a 429 means wait for the window named in Retry-After.
Body
Where the verification link goes. Lowercased before use. This is the person who will own the workspace and complete the payment.
254What to call the workspace. Held for 24 hours and used to prefill the form the recipient lands on; it does not create anything.
1 - 64The site to be tracked. A full URL is accepted and reduced to its hostname, so https://www.example.com/pricing is stored as www.example.com. Anything that is not a hostname is rejected rather than guessed at.
Response
Accepted. A verification email has been sent. Identical for an address that already has an account.
The only value this field takes. No workspace id, plan or key is returned here, or by any other route, before payment.
verification_sent