---
title: "List integration connections"
method: GET
path: "/integrations/connections"
tags: ["integrations"]
---

# List integration connections

`GET /integrations/connections`

Returns all configured integration connections in the workspace. Each connection stores credentials and settings for an external service (LLM provider, API, database).

## Response `200`

successful operation

- IntegrationConnection[]
  - `metadata` Metadata, required — Owner fields for Persistence
    - `createdAt` string — The date and time when the resource was created
    - `updatedAt` string — The date and time when the resource was updated
    - `createdBy` string — The user or service account who created the resource
    - `updatedBy` string — The user or service account who updated the resource
    - `displayName` string — Human-readable name for display in the UI. Can contain spaces and special characters, max 63 characters.
    - `externalId` string — Caller-owned identifier for external lookups. Max 64 chars, alphanumeric + dash.
    - `labels` MetadataLabels — Key-value pairs for organizing and filtering resources. Labels can be used to categorize resources by environment, project, team, or any custom taxonomy.
    - `name` string, required — Unique identifier for the resource within the workspace. Must be lowercase alphanumeric with hyphens, max 49 characters. Immutable after creation.
    - `plan` string — Billing plan tier applied to this resource (inherited from workspace account)
    - `url` string — Auto-generated endpoint URL for accessing this resource (for agents, functions, models, sandboxes)
    - `workspace` string — Name of the workspace this resource belongs to (read-only, set automatically)
  - `spec` IntegrationConnectionSpec, required — Specification defining the integration type, configuration parameters, and encrypted credentials
    - `config` object — Non-sensitive configuration parameters for the integration (e.g., organization ID, region)
    - `integration` string — Integration provider type (e.g., openai, anthropic, github, slack)
    - `sandbox` boolean — Whether this connection uses sandbox/test credentials instead of production
    - `secret` object — Encrypted credentials and API keys for authenticating with the external service

## Other responses

- `401` — Unauthorized - Invalid or missing authentication credentials
- `403` — Forbidden - Insufficient permissions to list integration connections
- `500` — Internal server error

---

[API](https://skmtc.net/blaxel/apis/blaxel-control-plane.md) · [All operations](https://skmtc.net/blaxel/apis/blaxel-control-plane/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blaxel/blaxel-control-plane/versions/dfa264bc72ee/schema)