---
title: "One folder and everything on it"
method: GET
path: "/api/folders/{id}"
tags: ["Folders"]
---

# One folder and everything on it

`GET /api/folders/{id}`

## Request

- Base URL: `https://morfee.furo.solutions`
- URL: `https://morfee.furo.solutions/api/folders/{id}`
- Auth: one of:
  - API key in header `X-Api-Key`
  - HTTP bearer

Any scope may call this: every key may read.

## Path parameters

- `id` string, required

## Response `200`

The folder and its templates.

- object
  - `folder` Folder
    - `id` string, required
    - `name` string, required
    - `templates` integer: How many templates sit on this shelf.
    - `createdAt` string, date-time
  - `templates` TemplateMeta[]
    - `id` string, required: The id to render with. Lower case, digits and dashes.
    - `name` string, required
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `createdBy` string, nullable: The email address that saved it first.
    - `folderId` string, nullable: null means it is in no folder.
    - `bindingCount` integer: How many fields are pointed at.
    - `listCount` integer: How many of those are lists.
    - `byHand` boolean: True when the template has logic in it but no bindings: written directly rather than built by pointing at a design. The builder cannot rebuild such a template and opens it read only.
    - `sizeKb` integer

## Other responses

- `401`: No key, an unknown key or a revoked one.
- `404`: Not there, or not yours. Both give the same answer on purpose: a different one would let a caller find out which ids exist in another organization.

---

[API](https://skmtc.dev/furo/apis/morfee.md) · [All operations](https://skmtc.dev/furo/apis/morfee/llms.txt) · [OpenAPI document](https://skmtc.dev/furo/apis/morfee/revisions/83f95f89653f?raw)
