Skip to main content
Send message
curl --request POST \
  --url https://api.dimedove.com/v1/apps/{app_id}/conversations/{conversation_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": {
    "content": "Hello, I need help with my order.",
    "role": "user"
  },
  "stream": true
}
'
{
  "id": "<string>",
  "created_at": 123,
  "conversation_id": "<string>",
  "object": "response",
  "output": [],
  "status": "completed"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
app_id
string
required

The unique identifier of the app.

​
conversation_id
string
required

The unique identifier of the conversation.

Body

application/json
​
message
MessageInput · object
required

The message object to send.

​
stream
boolean | null

Override the app's default streaming setting for this request. When true, the response is delivered as Server-Sent Events (SSE). When false, a single JSON response is returned. If omitted, the app's configured default is used.

Response

OK

​
id
string
required

Unique identifier for the response.

​
created_at
integer
required

Unix timestamp (in seconds) of when the response was generated.

​
conversation_id
string
required

The ID of the conversation this response belongs to.

​
object
string
default:response

The object type. Always 'response'.

​
output
ResponseOutputItem · object[]

The list of output items produced by the AI agent, including messages and function calls.

​
status
string
default:completed

The status of the response. Either 'completed' or 'failed'.