---
search:
  tags:
    - Operations
    - GET
seo:
  description: >-
    Returns the JSON Schema of each named tool's input… Reference for the GET
    /api/v1/connectors/{service}/versions/{version}/tools endpoint in the
    Charming API.
sidebar:
  label: Read the schemas of connector tools at a toolkit version
  badge: GET
title: Read the schemas of connector tools at a toolkit version
type: openapi-operation
---
Returns the JSON Schema of each named tool's input and output at one Composio toolkit version, the version an App's `charming:connectors/<service>@<version>` import names. Charming reads a version's schemas from Composio the first time anyone asks and keeps them. Name up to 50 tools, by slug in `slugs` or by the name an App imports in `functions`. Each caller may cause up to 200 reads from Composio an hour; schemas already stored cost nothing.

`GET /api/v1/connectors/{service}/versions/{version}/tools`

**Responses**

- `200` — Each named tool with its schemas, in the order asked.
- `400` — The version or a tool slug is not one Charming accepts.
- `401` — Sign-in required.
- `404` — The service is not in the catalog, or Composio has no such tool at that version or retired the version.
- `429` — The caller has used its hourly allowance of 200 schema reads from Composio. Schemas already stored cost nothing.
- `503` — Composio could not answer, or connectors are off on this server.

Response example, 200:

```json
{
  "ok": true,
  "service": "string",
  "version": "string",
  "tools": [
    {
      "tool": "string",
      "function": "string",
      "inputSchema": null,
      "outputSchema": null
    }
  ]
}
```

Found a bug or need a feature? [Tell us](/docs/capabilities/feedback) with `submit_feedback` or `POST /app/{id}/feedback`. Your feedback shapes what we build next.