1. Docs
  2. API Reference
  3. Resume a deferred account creation parked at the register form

Resume a deferred account creation parked at the register form

POST/v1/auth/accounts/resume

Completes a deferred account creation that was parked when an existing user submitted the register form while logged out, then signed in or reset their password. The parked names are unauthenticated register-form input, so the SPA first fetches them (GET accounts/resume) and calls this only after the signed-in owner explicitly confirms — never silently on sign-in. Guarded by UserJwtGuard and rate-limited to 10 per hour; the parked intent is claimed delete-first so a retried or concurrent call cannot double-create. Returns 201 with an access token bound to the new Account's first Application and sets the refresh and session-marker cookies, or 404 when there is no pending intent to resume.

Responses

application/json

  • dataCreateAccountResponseDto*

application/json

  • errorApiErrorBodyDto*

application/json

  • errorApiErrorBodyDto*

application/json

  • errorApiErrorBodyDto*

Returned object

Request
curl -X POST "https://auth.canopy-io.com/v1/auth/accounts/resume"
Response
{
  "data": {
    "access_token": "string",
    "token_type": "string",
    "expires_in": 0,
    "account": {
      "id": "string",
      "name": "string",
      "slug": "string"
    },
    "application": {
      "id": "string",
      "name": "string",
      "slug": "string"
    },
    "default_environment_slug": "string"
  }
}
Related endpoints
POSTRegister a new user
POSTCreate an additional Account for the authenticated admin (no new user)
GETReview the parked account-creation intent before resuming
DELETEDismiss the parked account-creation intent without creating anything
POSTLook up invite details by token
POSTAccept an invite
POSTAuthenticate and receive tokens
POSTSelect an Account from a pre-auth session (multi-Account login)
POSTSwitch the active Application in an authenticated session
POSTRefresh access token
POSTLogout and revoke tokens
GETVerify email address
POSTResend verification email
POSTResend verification email by token
POSTRequest password reset
POSTReset password with token
POSTChange password (authenticated)
GETGet current user profile
GETGet current user avatar image
POSTUpload profile avatar
DELETERemove profile avatar
POSTRequest an email-address change
POSTConfirm an email-address change
GETGet current user permissions
GETList the Accounts the current user belongs to
GETList active sessions
DELETERevoke all sessions
DELETERevoke a specific session
Was this page helpful?

Tell us how we can improve this guide.