---
title: "Get Fde Tool Catalog"
method: GET
path: "/api/v1/fde/tools/catalog"
tags: ["fde", "fde-conversations"]
---

# Get Fde Tool Catalog

`GET /api/v1/fde/tools/catalog`

## Query parameters

- `context_type` string, required — Which FDE context the toggles are for. Required: a default would silently restore the unfiltered catalog for any caller that forgot it, which is the defect this parameter exists to remove.
- `group_type` string, nullable — Which group substrate the toggles are for. Optional, and only meaningful for context_type=agent_group, where both voice agent groups and text widget groups share one context. Omitting it returns the unfiltered catalog for the context -- the behaviour every caller had before this parameter existed -- so an older frontend degrades to that rather than to an empty panel.

## Response `200`

Successful Response

- FDEToolCatalogResponse
  - `groups` FDEToolCatalogGroup[], required
    - `id` string, required
    - `label` string, required
    - `tools` FDEToolCatalogItem[], required
      - `name` string, required
      - `label` string, required

## Other responses

- `422` — Validation Error

## Changes

> 26 revisions in range; 1 not diffed.

- **2026-09-09** `14d0341c60b5` — 1 info
  - added the new optional `query` request parameter `group_type`
- **2026-09-05** `38166468bfc5` — 1 breaking, 1 info
  - added the new required `query` request parameter `context_type`
  - added the non-success response with the status `422`

[Change history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/fde/tools/catalog/get.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/4df7b22a7dae?raw)