user-states

Stream User States

Changed on

Stream board generation via SSE.

Accepts application/json (legacy, text-only) or multipart/form-data (new, supports any combination of audio, image, document, and feedback fields). When audio is provided, the stream emits transcribing → transcript before board partials. When an image or PDF is provided, the stream emits analyzing immediately so the UI can show progress before the agent starts.

Delivers partial board fields progressively as the agent generates them. If the client disconnects mid-stream on a text-only turn, generation completes in the background and a push notification is sent. Multimodal turns skip recovery (the upload would have to be redone) and surface the disconnect to the client instead.

post/user_states/stream

Request

  • Base URL
    https://api.imperfect.co (the document declares no server; this is the origin it was published from)
  • URL
    https://api.imperfect.co/user_states/stream
  • Auth
    HTTP bearer

Query parameters

user_idstring nullable

Headers

x-inbound-message-idstring nullable
accept-languagestring nullable
x-device-timezonestring nullable
x-unitsstring nullable
x-units-sourcestring nullable

Response

Successful Response

unknown required

Changes