---
title: "List your team's integrations"
method: GET
path: "/v1/integrations/team"
tags: ["integrations"]
---

# List your team's integrations

`GET /v1/integrations/team`

## Request

- Base URL: `https://api.pomerado.ai`
- URL: `https://api.pomerado.ai/v1/integrations/team`
- Auth: HTTP bearer

List the integrations your team built, private and public, and the public ones your team added.

Each built one lists the enabled tools your team created in it; an added one lists all its enabled tools. A Personal account sees its own integrations.

## Query parameters

- `cursor` string
- `limit` string

## Response `200`

One page of integrations

- object
  - `data` TeamIntegration[], required
    - `id` string, required: an integration ID: int_ and 32 lowercase hex digits
    - `name` string, required
    - `description` string, required
    - `site_url` string, nullable, required: The website's https origin, or null for an offline tool
    - `visibility` 'public' | 'private', required: public: published on Pomerado for every account to find and use. private: only your team sees, uses and edits it
    - `owned_by_me` boolean, required: Whether you created one of its tools, which you may delete
    - `added` boolean, required: Whether your account added it to My integrations
    - `built` boolean, required: Whether it holds a tool you or your team created
    - `icon_url` string, nullable, required: Its site's icon, a PNG on the API host; null when it has none. Fetch it with the same Authorization: Bearer <API key> header as the API, from a key that can read integrations (tools:read); a key for one integration fetches only its icon. Without credentials it answers 401, and it answers 404 while the site has no captured icon. The URL changes whenever the icon may, so an icon fetched from it can be kept
    - `tools` IntegrationTool[], required: The enabled tools your team's members created in it; all its enabled tools when your team added it
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `effect` 'read' | 'write', required
      - `login_required` boolean, required
    - `created_at` string, required: a string to be decoded into a Date
  - `next_cursor` string, nullable, required

## Other responses

- `400`: invalid_request
- `401`: unauthorized, reauthentication_required
- `403`: forbidden
- `500`: internal_error
- `503`: temporarily_unavailable

---

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