list_samples
Browse the bundled sample library: the real bio files a new project can start from (GenBank and SnapGene plasmids, FASTA sets, alignments, Sanger traces, structures, variant calls and more), each with its id, format and size, and its archive provenance where the corpus records one. This is the headless form of starting a project from a sample: pass an id as a _subject or _files entry's sample and the file is read exactly as the lobby opens it.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | restrict to one importer kind (sequence, msa, trace, structure, variants, alignment, tabular, …). Each entry reports its own, so the vocabulary is whatever the library holds. | |
| limit | No | most entries to return; `total` says how many matched. | |
| query | No | words that must all appear in the sample’s id, name, category or format label (case-insensitive), e.g. "pUC", "genbank plasmid", "ab1". Empty lists everything. | |
| _files | No | The project: record references shaped like _subject. Their records become library documents a tool names in sequences/parts/document; a trace or alignment is found by file name. | |
| _subject | No | The record to act on: exactly one of sequence, accession (+source), sample (an id from list_samples) or file ({name, text} or {name, base64}); record_index picks one record of several. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | just the ids, in the same order — the list to scatter a per-sample step over | |
| total | Yes | how many entries matched before `limit` was applied | |
| samples | Yes | the matching entries: id, name, category, format, label, kind, size and provenance when recorded |