BRbrandbooster
remy
remy

List Conversations Endpoint

Changed on

Conversations this user owns, paginated (?page=&size=), with a last-message preview for the list view.

Pass kind=campaign for the negotiation inbox: roster-invite threads live here too, and they have no brand, budget or deliverable to negotiate over.

get/api/v1/remy/conversations

Request

  • Base URL
    https://api.brandbooster.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.brandbooster.ai/api/v1/remy/conversations
  • Auth
    HTTP bearer

Query parameters

campaign_idstring nullable

Scope to one campaign; omit for all of this user's.

kindstring nullable

campaign | invite. Omitted = both.

searchstring nullable

Handle, display name or email substring, case-insensitive.

status'contacted' | 'negotiating' | 'closed' | 'rejected'

Four stable states — legacy's fifth value ("replied") was a transient step that its own auto-advance logic immediately overwrote with "negotiating" on the same call, so it never actually persisted as a stable state. Not carried over here.

Chip filter: contacted | negotiating | closed | rejected.

pageinteger
sizeinteger

Response

Successful Response

totalinteger
pageinteger
sizeinteger
pagesinteger
countsobject
agreed_valuenumber

Changes

  • 2a70cf5697f4Revision changes
    • breaking

      the response property became optional for the status

    • breaking

      the response property became optional for the status

    • breaking

      the response property became optional for the status

    • breaking

      the response property became optional for the status

    • info

      added the new optional query request parameter status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      the response's property default value was added for the status

    • info

      the response's property default value 1 was added for the status

    • info

      the response's property default value 0 was added for the status

    • info

      the response's property default value 50 was added for the status

    • info

      the response's property default value 0 was added for the status

    • info

      response property page list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property pages list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property size list-of-types was narrowed by removing types null from media type application/json of response 200

  • fff247daebe7Revision changes
    • breaking

      the response's body type changed from array to object for status

    • info

      added the new optional query request parameter page

    • info

      added the new optional query request parameter search

    • info

      added the new optional query request parameter size

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status