---
title: "List synthetic tools"
method: GET
path: "/synthetic-tool"
tags: ["Synthetic tools"]
---

# List synthetic tools

`GET /synthetic-tool`

## Request

- Base URL: `https://api.elaichi.ai`
- URL: `https://api.elaichi.ai/synthetic-tool`
- Auth: HTTP bearer

Lists synthetic tools (`syn_…`): multi-step tools defined in Elaichi rather than derived from a connector. They are placed in a template or toolbox as an entry of `type: "synthetic"`. Each row carries `owner` (`{ id, name, email }`) alongside `owner_user_id`; read it rather than resolving the id against the paginated member directory. Each row also carries `broken_step_count`, the number of steps whose connection has been deleted (0 = none).

## Query parameters

- `limit` integer
- `cursor` string
- `q` string

## Headers

- `X-Organization-Id` string

## Response `200`

OK

- object
  - `result` object[], required
  - `next_cursor` string, nullable, required
  - `prev_cursor` string, nullable, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `429`: Rate limited

---

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