Collections & Tags

Organize datasets into curated collections and apply tags for discovery.

Tags

Tags are free-form metadata labels attached to datasets. They surface in search results and help users discover related data.

Add Tags

Tags are assigned during dataset creation or updated afterward via the dataset metadata endpoints.

Search by Tags

curl "https://api.syndb.xyz/v1/search/fulltext?q=drosophila+mushroom+body"

The full-text search indexes dataset tags alongside titles and descriptions. See Search.

Collections

Collections are curated groupings of datasets — for example, “All Drosophila connectomes” or “Lab X publication datasets.”

Create a Collection

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  https://api.syndb.xyz/v1/neurodata/collections \
  -d '{
    "name": "Drosophila Connectomes",
    "notes": "All Drosophila melanogaster connectome datasets",
    "dataset_ids": [
      "11111111-1111-1111-1111-111111111111",
      "22222222-2222-2222-2222-222222222222"
    ]
  }'

List Collections

curl -H "Authorization: Bearer $TOKEN" \
  https://api.syndb.xyz/v1/neurodata/collections

Get a Collection

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

Collection membership is currently defined when the collection is created; there is no standalone POST /v1/neurodata/collections/{collection_id}/datasets route in the current API.

Collections are useful for meta-analysis: take the dataset_ids returned by the collection endpoints and pass them to the meta-analysis endpoint.