TRtrademeai
v1

Create a conversation

Changed on

Starts a new conversation owned by the signed-in member and returns it. All body fields are optional: title, referrer (the listing or page the member came from) and invitees (member ids to invite). Answers 503 while the assistant is switched off.

Error bodies are described in the error contract.

post/api/v1/assistant/trademe/conversations

Request

Headers

is-in-staff-groupstring nullable
authorizationstring nullable

Request body

titlestring nullable
inviteesstring[]

Response

Successful Response

idstring required
titlestring nullable
createdAtstring date-time required
updatedAtstring date-time required
lastMessageAtstring date-time nullable
isSharedboolean required
assistantStatus'idle' | 'running' | 'error'
messageCountinteger
capabilitiesstring[] nullable
kindstring

Changes

  • ca444ed0549dRevision changes
    • warning

      removed the request property

  • fef830d30272Revision changes
    • breaking

      added to the / response property oneOf list for the response status

    • info

      added property_deep_link discriminator mapping keys to the / request property

    • info

      added to the / request property oneOf list

    • info

      added property_deep_link discriminator mapping keys to the / response property for the response status