---
title: "List a connection's tools"
method: GET
path: "/connections/{id}/tools"
tags: ["Connections"]
---

# List a connection's tools

`GET /connections/{id}/tools`

## Request

- Base URL: `https://api.crevio.co/v1`
- URL: `https://api.crevio.co/v1/connections/{id}/tools`
- Auth: API key in header `Authorization`

The gateable tools a connection exposes, each with its effective approval policy. Works for any family — the backend dispatches by transport. Social/ads connections return a pointer to their native /v1 endpoints.

## Path parameters

- `id` string, required

## Response `200`

Success

- ListResponseConnectionCapability
  - `object` 'list', required
  - `data` union[], required
    - union
      - ConnectionTool
        - `object` 'connection_tool', required
        - `name` string, required: Tool name passed as `tool` to /execute
        - `label` string, required
        - `description` string, nullable
        - `policy` 'off' | 'always_ask' | 'always_allow', required: Effective approval policy
        - `default_policy` 'off' | 'always_ask' | 'always_allow', required
      - ConnectionPointer: A connection operated via its native typed endpoints rather than the generic execute surface.
        - `object` 'connection_pointer', required
        - `transport_hint` 'native'
        - `endpoints` string, required: Native API path prefix, e.g. /v1/socials
  - `has_more` boolean, required
  - `url` string, required

## Other responses

- `401`: Authentication required
- `403`: Forbidden
- `404`: Resource not found
- `422`: Validation error
- `429`: Rate limit exceeded — 600 requests per minute per credential. Retry after the number of seconds in `Retry-After`.
- `500`: Internal server error
- `502`: Upstream (provider) failure

---

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