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,
  "metadata": {
    "first_name": "John",
    "last_name": "Doe",
    "age": 34,
    "city": "Montreal"
  }
}
'
{
  "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.

metadata
Metadata · object

Arbitrary key-value context to enrich the AI agent's response. Pass the latest snapshot on any message, and the agent will use this fresh context for the current response and persist it as the conversation's latest metadata. Maximum 16KB.

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'.