Provenance & Citations

SynDB tracks dataset lineage, version history, and generates machine-readable citations.

Version History

Each dataset maintains a version history. View all versions:

curl -H "Authorization: Bearer $TOKEN" \
  https://api.syndb.xyz/v1/neurodata/datasets/{dataset_id}/versions

Provenance Chain

The provenance endpoint shows the audit trail — who created, modified, or derived from the dataset:

curl -H "Authorization: Bearer $TOKEN" \
  https://api.syndb.xyz/v1/neurodata/datasets/{dataset_id}/provenance

Lineage

Track derived-from relationships between datasets:

curl -H "Authorization: Bearer $TOKEN" \
  https://api.syndb.xyz/v1/neurodata/datasets/{dataset_id}/lineage

Citations

Generate citations in standard formats:

# BibTeX
curl "https://api.syndb.xyz/v1/neurodata/datasets/{dataset_id}/citation?format=bibtex"

# RIS (for [EndNote](https://endnote.com), [Zotero](https://www.zotero.org))
curl "https://api.syndb.xyz/v1/neurodata/datasets/{dataset_id}/citation?format=ris"

JSON-LD

Export dataset metadata as linked data for integration with knowledge graphs and semantic web tools:

curl "https://api.syndb.xyz/v1/neurodata/datasets/{dataset_id}/metadata.jsonld"

Returns a JSON-LD document following Schema.org and neuroscience ontology standards. See Data Standards for details on metadata formats.

Access Requests

For restricted datasets, request access from the dataset owner:

# Request access
curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  https://api.syndb.xyz/v1/neurodata/datasets/{dataset_id}/access/request \
  -d '{"purpose": "Reanalysis for comparative morphology study"}'

# Check access status
curl -H "Authorization: Bearer $TOKEN" \
  https://api.syndb.xyz/v1/neurodata/datasets/{dataset_id}/access

The dataset creator receives the request and can approve or deny it.

Keyboard shortcuts