---
title: "Proxy integrations.sh per-domain surface details (trimmed for the Add Connection flow)"
method: GET
path: "/api/integrations-catalog/{domain}/surface"
tags: ["Script Connections"]
---

# Proxy integrations.sh per-domain surface details (trimmed for the Add Connection flow)

`GET /api/integrations-catalog/{domain}/surface`

## Path parameters

- `domain` string, required

## Response `200`

Trimmed integration surface details for a domain

- object
  - `domain` string, required
  - `summary` string, required
  - `surfaces` object[], required
    - `type` string, required
    - `name` string, required
    - `url` string, nullable, required
    - `docs` string, nullable, required
    - `spec` string, nullable, required
    - `auth` object, required
      - `required` boolean, required
      - `credentialIds` string[], required
      - `mechanics` object, nullable, required
        - `in` string, required
        - `headerName` string, nullable, required
        - `scheme` string, nullable, required
  - `credentials` object, required

## Other responses

- `404` — No surface data for this domain
- `502` — Surface upstream unavailable

---

[API](https://skmtc.net/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.net/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/desplega-ai/agent-swarm-api/versions/db1079e034dc/schema)