HackNotice icon

HackNotice

Call the HackNotice extensions API (alerts, assessments, and more)

Actions85

Assessment Data File → Get File Metadata

AI-generated

Summary

Fetches the metadata record for a single assessment data file from HackNotice by its document ID (GET /assessmentdatafiles/:docId). Does not download file contents.

Inputs

  • Document ID (required) — ID of the assessment data file. It is trimmed and URL-encoded into the request path. The node throws an error if it is empty.
  • Page Number — Shown in the UI but not used by this operation, because the path has no page segment.
  • Invite Code — Shown in the UI but not used by this operation.
  • Request Body — Shown in the UI but ignored. This is a GET request and no body is sent.

Output shape

One output item per returned record, normally a single JSON object holding the file's metadata as returned by the API. If the API returns an array, each element becomes its own item. Each item is paired to the input item.

The metadata fields are whatever the HackNotice API returns, and the source does not define them. No binary data is returned; use the Download File operation for contents. API errors are raised as node errors, which a workflow can catch if the node's error handling is configured to do so.

Examples

Example 1: Check a file's details before downloading it

Resource: Assessment Data File; Operation: Get File Metadata; Document ID: an expression such as {{$json.fileId}}

Example 2: Look up a file found by listing files

After a List Files (Page) node, set Document ID to {{$json._id}} to fetch each file's full metadata

Links

Discussion