---
title: "Read one connector card from a plane service into the catalog (super_admin)"
method: POST
path: "/api/admin/connectors/remote/sync"
tags: ["connectors"]
---

# Read one connector card from a plane service into the catalog (super_admin)

`POST /api/admin/connectors/remote/sync`

## Request

- Base URL: `https://api.wizbi.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wizbi.ai/api/admin/connectors/remote/sync`
- Auth: none declared

Calls the service as the runtime identity: `/health`, `<endpoint>/manifest` (a v2 module with its tools), the logo (checked: a small inert SVG) and the skill. Stores a new version in `platform_connectors/{id}` and registers the type as a connector and a module (defaults from its manifest). A card named like a built-in type is refused.

## Request body

- RemoteConnectorSync
  - `service` string, uri, required
  - `card` string

## Response `200`

The synced type.

- object
  - `type` RemoteConnectorRow, required
    - `id` string, required
    - `service` string, required
    - `endpoint` string, required
    - `version` string, required
    - `major` number, required
    - `catalogVersion` number, required
    - `enabled` boolean, required
    - `hasLogo` boolean, required
    - `hasSkill` boolean, required
    - `tools` object[], required
      - `name` string, required
      - `grade` string, required
    - `syncedAt` string, required
    - `syncedBy` string, required

## Other responses

- `400`: Invalid request, or the card does not validate.
- `403`: super_admin only.
- `404`: Unknown remote connector type.
- `502`: The plane service did not answer.

---

[API](https://skmtc.dev/wizbi/apis/wizbi-core-api.md) · [All operations](https://skmtc.dev/wizbi/apis/wizbi-core-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wizbi/apis/wizbi-core-api/revisions/5a47416c82ec?raw)
