---
title: "Send Workspace Chat Message"
method: POST
path: "/v1/workspaces/{workspaceId}/chats/{chatId}/messages"
tags: ["Replica"]
---

# Send Workspace Chat Message

`POST /v1/workspaces/{workspaceId}/chats/{chatId}/messages`

Accepts a message immediately. Messages sent while a workspace is preparing or sleeping are queued server-side and delivered in order after startup completes. Archived and error workspaces return 409.

## Path parameters

- `workspaceId` string, uuid, required
- `chatId` string, uuid, required

## Request body

- SendWorkspaceChatMessageRequest
  - `message` string, required
  - `messageId` string
  - `submittedAt` string, date-time
  - `model` string
  - `images` ImageContent[]
    - `type` 'image', required — Content type, always 'image'
    - `source` union, required — Image source data
      - object
        - `type` 'base64', required
        - `media_type` 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp', required — MIME type of the image
        - `data` string, required — Base64-encoded image data
      - object
        - `type` 'url', required
        - `url` string, uri, required — URL to the image
  - `planMode` boolean
  - `goalMode` boolean
  - `fastMode` boolean
  - `thinkingLevel` 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'ultra' | 'ultracode'

## Response `200`

Message accepted by an active workspace

- SendWorkspaceChatMessageResponse
  - `messageId` string, required
  - `queued` boolean, required
  - `position` integer, required

## Other responses

- `202` — Message queued while the workspace starts
- `400` — Bad request - Missing or invalid parameters
- `401` — Unauthorized - Invalid or missing API key
- `404` — Resource not found
- `409` — Conflict - Resource already exists or operation conflicts with current state
- `500` — Internal server error

---

[API](https://skmtc.dev/tryreplicas/apis/replica-api.md) · [All operations](https://skmtc.dev/tryreplicas/apis/replica-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tryreplicas/replica-api/revisions/aa3b4c932f7a/schema)