Qoder CN Series:List Dreams

Request headers

Header	Required	Description
Authorization	Yes	Bearer <PAT>

Query parameters

Parameter	Type	Required	Default	Description
limit	integer	No	20	Maximum number of results to return (1-100).
include_archived	boolean	No	false	Whether to include archived Dreams.

Sample request

curl -s 'https://api.qoder.com.cn/api/v1/cloud/dreams?limit=5' \
  -H "Authorization: Bearer $QODER_PAT"

Sample response

HTTP 200 OK

{
  "data": [
    {
      "id": "drm_019e86b4a8f070a3b6c5d4e3f2a1b0c9",
      "type": "dream",
      "status": "completed",
      "inputs": [{ "type": "memory_store", "memory_store_id": "memstore_019e5cdb9c3f71c3b6505eba937a40b4" }],
      "outputs": [{ "type": "memory_store", "memory_store_id": "memstore_019e86b4b10578059435632bb357c5ed", "files_touched": ["preferences.md"] }],
      "model": { "id": "auto" },
      "instructions": "",
      "session_id": "sess_019e86b4b10578059435632bb357c5ed",
      "usage": { "input_tokens": 12500, "output_tokens": 3200, "cache_creation_input_tokens": 0, "cache_read_input_tokens": 8000 },
      "error": null,
      "created_at": "2026-06-15T10:00:00Z",
      "ended_at": "2026-06-15T10:03:42Z",
      "archived_at": null
    }
  ]
}

Error codes

HTTP	code	Trigger condition
401	TOKEN_INVALID	Missing or invalid authentication token. The response body also includes a message field: missing authorization token when no auth header is provided, or invalid pt-token when the token is invalid.

For the full error envelope specification, see Errors.