Claude Platform Docs

梦境

创建梦境
$client->beta->dreams->create(list<BetaDreamInput> inputs, Model model, ?string instructions, ?BetaOutputBehavior outputBehavior, ?list<AnthropicBeta> betas, ?string workspaceID): BetaDream
POST/v1/dreams
Requires anthropic-beta: dreaming-2026-04-21. How to send beta headers

启动一个异步作业，该作业使用过去的会话生成记忆存储的重组版本，并返回梦境以供您轮询结果。

列出梦境
$client->beta->dreams->list(?\Datetime createdAtGt, ?\Datetime createdAtLt, ?bool includeArchived, ?int limit, ?string page, ?list<BetaDreamStatus> statuses, ?list<AnthropicBeta> betas, ?string workspaceID): PageCursor<BetaDream>
GET/v1/dreams
Requires anthropic-beta: dreaming-2026-04-21. How to send beta headers

按从新到旧的顺序列出工作区中的梦境。

获取梦境
$client->beta->dreams->retrieve(string dreamID, ?list<AnthropicBeta> betas, ?string workspaceID): BetaDream
GET/v1/dreams/{dream_id}
Requires anthropic-beta: dreaming-2026-04-21. How to send beta headers

通过 ID 获取梦境，以检查其状态、输出记忆存储和令牌用量。

取消梦境
$client->beta->dreams->cancel(string dreamID, ?list<AnthropicBeta> betas, ?string workspaceID): BetaDream
POST/v1/dreams/{dream_id}/cancel
Requires anthropic-beta: dreaming-2026-04-21. How to send beta headers

停止处于 pending 或 running 状态的梦境。

归档梦境
$client->beta->dreams->archive(string dreamID, ?list<AnthropicBeta> betas, ?string workspaceID): BetaDream
POST/v1/dreams/{dream_id}/archive
Requires anthropic-beta: dreaming-2026-04-21. How to send beta headers

将处于 completed、failed 或 canceled 状态的梦境从默认梦境列表中隐藏。

Models
class BetaDream { $type = 'dream'; $id; $archivedAt; /* 11 more */ }
class BetaDreamError { $type; $message; }
string type

A code for why the dream failed, such as timeout or internal_error.

The Dreams guide lists common error codes and when they occur.

string message

A human-readable explanation of why the dream failed.

class BetaDreamInput
One of the following:
class BetaDreamMemoryStoreInput { $type = 'memory_store'; $memoryStoreID; }
"memory_store" type
string memoryStoreID

The ID of the memory store for the dream to read (memstore_...).

The memory store must be in the same workspace as the dream and must not be archived.

class BetaDreamSessionsInput { $type = 'sessions'; $sessionIDs; }
"sessions" type
list<string> sessionIDs

The IDs of the sessions whose transcripts the dream reads (sesn_...).

Give 1 to 100 IDs, with no duplicates. Each session must be in the same workspace as the dream. Responses list the IDs in sorted order.

class BetaDreamMemoryStoreInput { $type = 'memory_store'; $memoryStoreID; }
"memory_store" type
string memoryStoreID

The ID of the memory store for the dream to read (memstore_...).

The memory store must be in the same workspace as the dream and must not be archived.

class BetaDreamMemoryStoreOutput { $type = 'memory_store'; $memoryStoreID; }
"memory_store" type
string memoryStoreID

The ID of the memory store that the dream writes its result to (memstore_...).

With output_behavior set to create_new, this is a new memory store. With update_existing, it is the input memory store.

class BetaDreamModelConfig { $id; $speed; }
string id

The ID of the model that runs the dream, as given in the request that created it.

?Speed speed⁠

How fast the model generates output for the dream. Always standard.

class BetaDreamModelConfigParam { $id; $speed; }
string id

The ID of the model to run the dream with.

The ID can be 1 to 256 characters long.

The Availability section of the Dreams guide lists the supported models.

?Speed speed

How fast the model generates output for the dream. Defaults to standard.

Dreams accept only standard.

class BetaDreamOutput { $type = 'memory_store'; $memoryStoreID; }
"memory_store" type
string memoryStoreID

The ID of the memory store that the dream writes its result to (memstore_...).

With output_behavior set to create_new, this is a new memory store. With update_existing, it is the input memory store.

class BetaDreamSessionsInput { $type = 'sessions'; $sessionIDs; }
"sessions" type
list<string> sessionIDs

The IDs of the sessions whose transcripts the dream reads (sesn_...).

Give 1 to 100 IDs, with no duplicates. Each session must be in the same workspace as the dream. Responses list the IDs in sorted order.

enum BetaDreamStatus
One of the following:
"pending"

The dream is waiting to start and hasn't read its inputs yet.

outputs is empty and every usage count is zero.

"running"

The dream is reading its inputs and writing its result.

usage updates while the dream has this status.

"completed"

The dream finished and its output memory store holds the complete result.

"failed"

The dream stopped with an error, which error describes.

If outputs references a memory store, that memory store keeps what the dream wrote before it stopped.

"canceled"

A cancel request stopped the dream before it reached completed or failed.

If outputs references a memory store, that memory store keeps what the dream wrote. usage can keep changing after the cancel.

class BetaDreamUsage { $cacheCreationInputTokens; $cacheReadInputTokens; $inputTokens; $outputTokens; }
int cacheCreationInputTokens

The dream's input tokens that were written to the prompt cache, for both the 5-minute and 1-hour cache durations.

int cacheReadInputTokens

The dream's input tokens that were read from the prompt cache.

int inputTokens

The dream's input tokens that weren't read from or written to the prompt cache.

int outputTokens

The tokens that the model generated for the dream.

class BetaDreamingError
One of the following:
class BetaOutputBehavior
One of the following:
class BetaOutputBehaviorCreateNew { $type = 'create_new'; }
"create_new" type
class BetaOutputBehaviorUpdateExisting { $type = 'update_existing'; $memoryStoreID; }
"update_existing" type
string memoryStoreID

The ID of the memory store for the dream to write its result to (memstore_...). It must be the memory store in the memory_store entry of inputs.

class BetaOutputBehaviorCreateNew { $type = 'create_new'; }
"create_new" type
class BetaOutputBehaviorUpdateExisting { $type = 'update_existing'; $memoryStoreID; }
"update_existing" type
string memoryStoreID

The ID of the memory store for the dream to write its result to (memstore_...). It must be the memory store in the memory_store entry of inputs.

class BetaTargetStoreHeldError { $type = 'conflict_error'; $message; }
"conflict_error" type
?string message

A human-readable explanation of why the memory store can't be used yet, with the ID of the dream that is using it when the server can identify it.