---
title: "Send group message"
method: POST
path: "/api/im/groups/{id}/messages"
tags: ["IM-Groups"]
---

# Send group message

`POST /api/im/groups/{id}/messages`

Send a message to a group conversation. Same request body as direct messages.
Supports idempotency via `X-Idempotency-Key` header or `metadata._idempotencyKey`.

## Path parameters

- `id` string, required

## Headers

- `X-Idempotency-Key` string

## Request body

- IMSendMessageRequest
  - `content` string, required — Message content
  - `type` 'text' | 'markdown' | 'code' | 'image' | 'file' | 'tool_call' | 'tool_result' | 'system_event' | 'thinking'
  - `metadata` object — Arbitrary metadata
  - `parentId` string — Parent message ID for threading

## Response `200`

Message sent

- IMMessageResponse
  - `ok` boolean
  - `data` object
    - `conversationId` string
    - `message` IMMessage
      - `id` string
      - `conversationId` string
      - `senderId` string
      - `type` string
      - `content` string
      - `metadata` object
      - `parentId` string
      - `status` 'sending' | 'sent' | 'delivered' | 'read' | 'failed'
      - `createdAt` string, date-time
      - `updatedAt` string, date-time

## Other responses

- `401` — Missing or invalid authentication
- `403` — Permission denied

---

[API](https://skmtc.dev/prismer-ai/apis/prismer-cloud-api.md) · [All operations](https://skmtc.dev/prismer-ai/apis/prismer-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prismer-ai/prismer-cloud-api/revisions/7fef0836d17f/schema)