List archived files

list_archived

Through	Form
HTTP	`GET https://api.markdownbrain.ai/v1/archive`
MCP	tool `list_archived`
CLI	`mdbrain call list_archived`

What has been put away in a workspace: the same listing list_files returns, for the archived part of the tree instead of the ordinary part. A node is archived when it was put away itself or sits under something that was, and each row carries archived_at — the stamp, which is set on the node someone actually archived and null on everything beneath it. Takes the same under, name_contains and changed_since as list_files. It never returns content: the index is the expensive thing archiving exists to shrink, so a call handing back documents would hand back exactly what was put away. Read one with read_file, which reaches an archived document unchanged.

Who may call it: agents and people.

Writes: no, it only reads.

Arguments

Name	Type	Required	Travels in	Description
`workspace_id`	string	yes	query string	Workspace id
`changed_since`	string	no	query string	ISO timestamp — only files whose content or node changed after this are returned
`name_contains`	string	no	query string	Case-insensitive substring of the node's own name — for when you know roughly what it is called
`under`	string	no	query string	Folder path; return only that subtree of the archive. "" or omitted means the whole workspace

Success

200 with application/json.

Example request

curl 'https://api.markdownbrain.ai/v1/archive?workspace_id=00000000-0000-4000-8000-000000000010' \
  -H "Authorization: Bearer $MDBRAIN_API_KEY"

mdbrain call list_archived \
  --workspace-id 00000000-0000-4000-8000-000000000010

Example response

[
  {
    "id": "00000000-0000-4000-8000-000000000107",
    "parent_id": "00000000-0000-4000-8000-000000000101",
    "name": "07-old-pricing.md",
    "type": "file",
    "updated_at": "2026-02-20T11:00:00.000000+00:00",
    "content_updated_at": "2026-01-28T14:05:00.000000+00:00",
    "path": "specs/07-old-pricing.md",
    "title": "Old pricing",
    "summary": "The pricing we ran before the March change, kept for reference. - Three…",
    "archived_at": "2026-02-20T11:00:00.000+00:00"
  }
]

Refusals

A refusal is a status code with { error: { code, message } }. See Errors.