PATCH
Onboarding step 3 — description

Overview

Submits the listing’s free-text description. This is the companion to step 3 — photos: both must be present before currentStep advances to 4. Saving the description sets currentStep = 4. Photos must already be on the listing — submitting the description first returns 409 STATE_CONFLICT. The description is constrained to 50..150 characters inclusive (deliberate — short enough for one card, long enough to be more than a tweet). Preconditions:
  • currentStep is exactly 3.
  • A step-2 listing exists with at least one photo (i.e. step-3-photos has already fired).

Authentication

Bearer <accessToken> required. Scope: user.

Path parameters

None.

Query parameters

None.

Request body

Example payload

Response — 200 OK

Returns the refreshed onboarding state. currentStep advances to 4.

Example response

Error responses

Example error — 400

Side effects

  • Sets current_homes.description to the submitted text.
  • Sets users.currentStep = 4.

See also

curl