Initiate a retirement-account signup for a user (returns a human confirm link)

Creates a pending signup and returns signup_url, a link the HUMAN account owner must open personally to join the waitlist. Idempotent on email: repeating the same email returns the existing signup (HTTP 200). The account owner must personally open signup_url to confirm. Agents cannot complete enrollment, identity verification, suitability, or brokerage agreements on a person's behalf.

post/api/agent/signups

Request

  • Base URL: https://gigaverse.ai
  • URL: https://gigaverse.ai/api/agent/signups
  • Auth: none declared

Request body

emailstring email required

The user's email address.

namestring

The user's name (first name is fine).

platformsstring[]

Gig platforms the user works on, e.g. ["uber","doordash"].

partner_idstring

Optional partner attribution slug (from POST /api/agent/partners).

sandboxboolean

true = test mode: nothing stored, no email sent; returned gv_test_ signup auto-progresses initiated → waitlist_joined (60s) → account_opened (180s).

Response

Signup already existed for this email (idempotent replay).

signup_idstring
statusstring
signup_urlstring

The human account owner must open this personally.

status_urlstring
partner_idstring nullable
human_action_requiredstring
disclosuresstring

Changes

No recorded changes to this operation across all 1 revision of this API.