FourDN Get File Metadata

Overview

Get detailed metadata for specific 4DN files including Hi-C contact matrices, TAD (Topologically Associating Domain) calls, A/B compartment annotations, and chromatin loop lists. Returns file type, format, size (check before downloading - files can be GBs), description, associated experiment, and biosource information. Prerequisites: Requires file accession - obtain by using FourDN_search_data with item_type='File'. Use for: checking file details before download, understanding processing pipeline, accessing quality metrics.

Status

The most recent probe succeeded. Safe to call from the agent today.

Last probed

1d ago

Last success

1d ago

Last latency

114ms

Schema

JSON Schema the agent (or your API call) must match.

{
  "properties": {
    "file_accession": {
      "description": "4DN file accession (e.g., '4DNFIIA7E3HL'). Obtain by searching with FourDN_search_data (item_type='File').",
      "type": "string"
    },
    "include_full_metadata": {
      "default": false,
      "description": "Include complete API response in 'metadata' field (default: false). Set to true only if you need all raw fields. Omitting this reduces response size by ~97%.",
      "type": "boolean"
    },
    "operation": {
      "default": "get_file_metadata",
      "enum": [
        "get_file_metadata"
      ],
      "type": "string"
    }
  },
  "required": [
    "operation",
    "file_accession"
  ],
  "type": "object"
}

Examples (1)

{
  "file_accession": "P38398",
  "include_full_metadata": false,
  "operation": ""
}

Identifiers

Catalog ID

tu_FourDN_get_file_metadata

Tool name

FourDN_get_file_metadata

Added

2026-05-01 00:58Z

Tags

tooluniverse