---
title: "Get server feature flags"
method: GET
path: "/api/features"
tags: ["node"]
---

# Get server feature flags

`GET /api/features`

Returns the server's feature capabilities

## Response `200`

Success

- object
  - `free_tier_balance` object — Free-tier job allowance for an authenticated non-paid (FREE-tier) user in the rollout. Absent for paid users and unauthenticated requests. Synthesized from config before a grant row exists so a brand-new user still sees their full allowance.
    - `allowance` integer, required — Total free jobs granted for the current period
    - `remaining` integer, required — Free jobs remaining (allowance - used, floored at 0)
    - `used` integer, required — Free jobs consumed so far
  - `max_upload_size` integer — Maximum upload size in bytes
  - `supports_preview_metadata` boolean — Whether the server supports preview metadata

## Changes

> 38 revisions in range; 2 could not be searched.

- **2026-07-17** `9fb6092a836d` — 1 info
  - added the optional property `free_tier_balance` to the response with the `200` status
- **2026-07-13** `c45ef26ef9b8` — 1 warning
  - removed the optional property `supports_model_type_tags` from the response with the `200` status
- **2026-07-09** `a4a552164a69` — 1 info
  - added the optional property `supports_model_type_tags` to the response with the `200` status
- **2026-06-03** `8560879e6188` — 1 breaking, 5 warning, 6 info
  - the `max_upload_size` response's property type/format changed from `integer`/`int64` to `integer`/`` for status `200`
  - removed the optional property `free_tier_credits` from the response with the `200` status
  - removed the optional property `max_concurrent_jobs` from the response with the `200` status
  - removed the optional property `posthog_api_host` from the response with the `200` status
  - …8 more
- **2026-05-05** `0d50eed29d03` — 6 info
  - added the optional property `free_tier_credits` to the response with the `200` status
  - added the optional property `max_concurrent_jobs` to the response with the `200` status
  - added the optional property `max_upload_size` to the response with the `200` status
  - added the optional property `posthog_api_host` to the response with the `200` status
  - …2 more

[Full history](https://skmtc.dev/comfy-org/apis/comfyui-api/changes/api/features/get.md)

---

[API](https://skmtc.dev/comfy-org/apis/comfyui-api.md) · [All operations](https://skmtc.dev/comfy-org/apis/comfyui-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/comfy-org/comfyui-api/revisions/da017caf56f1/schema)