picks

Wait for the user's pick

Wait for the user to choose on the pick page. Long-polls up to 50 seconds—returns as soon as they click, or status "pending" after the wait (call again if so).

Once chosen, returns their reference with its screenshot and a full build prompt, so you can start building from it immediately. If they clicked "None of these fit", status is "dismissed" and you should ask what they want instead.

get/api/v1/picks/{pickId}

Request

  • Base URL: https://screenrove.com
  • URL: https://screenrove.com/api/v1/picks/{pickId}
  • Auth: none declared

Path parameters

pickIdstring required

The pickId returned by pickReference.

Query parameters

waitinteger

Seconds to wait for a choice, 0 to 50.

Response

The pick's status and, once chosen, the reference and build prompt.

pickIdstring
status'pending' | 'chosen' | 'dismissed'
messagestring
promptstring

Build prompt for the chosen reference.

Changes

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