Post apiassetsquery
POST /api/assets/query/ — structured metadata query (Phase 1 DSL).
Query Parameters
Opaque cursor from a previous page response.
Max assets to return. Default 100, max 1000.
Body
Phase 1 metadata query: {"and": [, ...]}
project- projectuser- user
project, user Asset type enum values. OR logic.
dataset- Datasetsample_specimen- Sample / Specimensynthesis- Synthesisfabrication- Fabricationprocessing- Processingassembly- Assemblymeasurement- Measurementimaging- Imagingspectroscopy- Spectroscopydiffraction_scattering- Diffraction / Scatteringmechanical_testing- Mechanical Testingthermal_analysis- Thermal Analysiselectrical_testing- Electrical Testingchemical_assay- Chemical Assaybiological_assay- Biological Assayenvironmental_observation- Environmental Observationcalibration- Calibrationquality_control- Quality Controlsimulation- Simulationanalysis- Analysisprotocol_workflow- Protocol / Workflowsoftware_code- Software / Code
dataset, sample_specimen, synthesis, fabrication, processing, assembly, measurement, imaging, spectroscopy, diffraction_scattering, mechanical_testing, thermal_analysis, electrical_testing, chemical_assay, biological_assay, environmental_observation, calibration, quality_control, simulation, analysis, protocol_workflow, software_code Text search across title, description, and alias
Opt in to scanning metadata values with ILIKE. Disables the GIN index — avoid on large datasets.
Asset UUID (exact) or alias (icontains)
Creator name or email (icontains)
Response
255255dataset- Datasetsample_specimen- Sample / Specimensynthesis- Synthesisfabrication- Fabricationprocessing- Processingassembly- Assemblymeasurement- Measurementimaging- Imagingspectroscopy- Spectroscopydiffraction_scattering- Diffraction / Scatteringmechanical_testing- Mechanical Testingthermal_analysis- Thermal Analysiselectrical_testing- Electrical Testingchemical_assay- Chemical Assaybiological_assay- Biological Assayenvironmental_observation- Environmental Observationcalibration- Calibrationquality_control- Quality Controlsimulation- Simulationanalysis- Analysisprotocol_workflow- Protocol / Workflowsoftware_code- Software / Code
dataset, sample_specimen, synthesis, fabrication, processing, assembly, measurement, imaging, spectroscopy, diffraction_scattering, mechanical_testing, thermal_analysis, electrical_testing, chemical_assay, biological_assay, environmental_observation, calibration, quality_control, simulation, analysis, protocol_workflow, software_code 100An OpenAlex Work shaped for the sidebar citation exporter.
authors / venue / biblio are read off the stored OpenAlex
metadata payload — the same extraction beta's unified works search uses
for its result rows (works_search_views._authors_from_work_dict /
_venue_from_work_dict) — so rendering one linked work needs NO
WorkAuthor / Person / Source joins. Read-only; Works are ingested data.
Defined above AssetSerializer so its cited_work field can reference
this class in @extend_schema_field (which also registers the component).