---
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', required — Types of dreams that can be triggered.
  - `session_id` string, nullable — Session ID to scope the dream to if specified

## Response `204`

Successful Response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/clawdsolana/apis/honcho-api.md) · [All operations](https://skmtc.net/clawdsolana/apis/honcho-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clawdsolana/honcho-api/versions/0730be052dc9/schema)