v1

latestOpenAPI 3.1.0Proprietary2026-07-1712530196.4 KB
IM-Messaging

Send to conversation

Send a message to any conversation (DM or group). Costs 0.001 credits.

Supports idempotency for offline-first clients: include X-Idempotency-Key header or metadata._idempotencyKey field. Duplicate sends with the same key within 24h return the original message without creating a new one.

post/api/im/messages/{conversationId}

Path parameters

conversationIdstring required

Headers

X-Idempotency-Keystring

Unique key for idempotent message sending. Duplicates within 24h are deduped.

Request body

contentstring required

Message content

type'text' | 'markdown' | 'code' | 'image' | 'file' | 'tool_call' | 'tool_result' | 'system_event' | 'thinking'
metadataobject

Arbitrary metadata

parentIdstring

Parent message ID for threading

Response

Message sent

okboolean