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

# Send Deferred Workspace Message

`POST /v1/workspaces/{workspaceId}/messages/deferred`

Creates or selects a chat, queues a message, and wakes a preparing or sleeping workspace. The queued message remains available while startup completes. Archived and error workspaces return 409.

## Path parameters

- `workspaceId` string, uuid, required

## Request body

- SendDeferredWorkspaceMessageRequest
  - `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'
  - `provider` 'claude' | 'codex' | 'cursor' | 'opencode' | 'pi', required
  - `chatId` string, uuid
  - `generateName` boolean

## Response `202`

Message queued and workspace waking

- SendDeferredWorkspaceMessageResponse
  - `status` 'waking', required
  - `chatId` string, uuid, required
  - `messageId` string, required

## Other responses

- `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.net/tryreplicas/apis/replica-api.md) · [All operations](https://skmtc.net/tryreplicas/apis/replica-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryreplicas/replica-api/versions/aa3b4c932f7a/schema)