---
title: "GET /api/v1/files/{fileNodeId}"
method: GET
path: "/api/v1/files/{fileNodeId}"
---

# GET /api/v1/files/{fileNodeId}

`GET /api/v1/files/{fileNodeId}`

## Request

- Base URL: `https://falconer.com` (the document declares no server; this is the origin it was published from)
- URL: `https://falconer.com/api/v1/files/{fileNodeId}`
- Auth: none declared

Read a file placed in the navigation: its metadata, where it sits, a snippet that inserts it into document content, and a short-lived download URL.

## Path parameters

- `fileNodeId` string, required: File id: the fileNodeId of a type file nav item or a placed upload.

## Headers

- `x-organization-id` string: Required when using OAuth bearer tokens.

## Response `200`

File metadata and a short-lived download URL

- LibraryFile
  - `id` string, required: File id, the fileNodeId of its nav item.
  - `filename` string, required
  - `mimeType` string, required
  - `size` integer, required
  - `updatedAt` string, required
  - `url` string, required: The file page in Falconer.
  - `downloadUrl` string, required: Short-lived URL for the bytes. Download it promptly; never persist it.
  - `snippet` string, required: Markdown snippet that inserts the file into document content.
  - `navItemId` integer, required
  - `parentFolderId` integer, nullable, required: The folder the file sits in; null at a section root.
  - `section` 'company' | 'private', required: Where the document landed. Without a parent it lands in your private section.

## Other responses

- `404`: File not found, or not visible to the caller

## Changes

- **2026-10-20** `7b303b7ddf6a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/falconer/apis/falconer-public-api/changes/api/v1/files/:fileNodeId/get.md)

---

[API](https://skmtc.dev/falconer/apis/falconer-public-api.md) · [All operations](https://skmtc.dev/falconer/apis/falconer-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/falconer/apis/falconer-public-api/revisions/7b303b7ddf6a?raw)