Send human-authored message | Runtype Documentation

curl -X POST https://api.runtype.com/v1/messaging/conversations/id/send \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "content": "Hello, I wanted to follow up on our last conversation and see if you have any updates regarding the project timeline."
}'

{
  "deliveryResult": {
    "deliveryStatus": "delivered",
    "externalMessageId": "msg-789456123"
  },
  "message": {
    "content": "Hello, I wanted to follow up on our last conversation and see if you have any updates regarding the project timeline.",
    "conversationId": "conv-123456789",
    "createdAt": "2024-06-01T10:15:30Z",
    "direction": "outbound",
    "externalMessageId": "msg-789456123",
    "metadata": {},
    "role": "user",
    "id": "msg-0011223344"
  }
}

Send a human-authored outbound message through the conversation’s messaging channel.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

Request

This endpoint expects an object.

contentstringRequired1-50000 characters

metadataobjectOptional

requireHumanModebooleanOptionalDefaults to true

Response

Message sent to channel

deliveryResultobject

messageobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error

502

Bad Gateway Error