---
title: "Schedule Dream"
method: POST
path: "/v3/workspaces/{workspace_id}/schedule_dream"
tags: ["workspaces"]
---

# Schedule Dream

`POST /v3/workspaces/{workspace_id}/schedule_dream`

Manually schedule a dream task for a specific collection.

This endpoint bypasses all automatic dream conditions (document threshold,
minimum hours between dreams) and schedules the dream task for a future execution.

Currently this endpoint only supports scheduling immediate dreams. In the future,
users may pass a cron-style expression to schedule dreams at specific times.

## Path parameters

- `workspace_id` string, required

## Request body

- ScheduleDreamRequest
  - `observer` string, required — Observer peer name
  - `observed` string, nullable — Observed peer name (defaults to observer if not specified)
  - `dream_type` 'omni' | 'card_refresh', required — Types of dreams that can be triggered.
  - `session_id` string, nullable — Session ID to scope the dream to if specified
  - `rebuild` boolean — card_refresh dreams only: rebuild the peer card solely from observations currently in the collection, without injecting the existing card (use after removals)

## Response `204`

Successful Response

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-12** (v3) `4e34e9b48a23` — 2 info
  - added the new optional request property `rebuild`
  - added the new `card_refresh` enum value to the request property `dream_type`
- **2026-02-26** (v3) `0730be052dc9` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-01-26** (v3) `839ffcc7e8bb` — 2 info
  - the request property `session_id` became optional
  - request property `session_id` list-of-types was widened by adding types `null` to media type `application/json`

[Change history](https://skmtc.dev/plastic-labs/apis/honcho-api/changes/v3/workspaces/:workspace_id/schedule_dream/post.md)

---

[API](https://skmtc.dev/plastic-labs/apis/honcho-api.md) · [All operations](https://skmtc.dev/plastic-labs/apis/honcho-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/plastic-labs/honcho-api/revisions/63b701d883c9/schema)