> ## Documentation Index
> Fetch the complete documentation index at: https://docs.refy.to/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectores

> Catalogo e instalacoes de conectores do Refy.

# Conectores

Conectores ligam o Refy a superficies externas.

## O que existe hoje

A API expõe:

* catalogo de conectores
* instalacoes por area de trabalho
* ativacao de instalacoes

## Modelo atual

A API separa:

* definições disponíveis no catálogo
* instalacoes concretas dentro da area de trabalho

## Rotas principais

* `GET /v1/workspaces/{workspaceId}/connectors`
* `POST /v1/workspaces/{workspaceId}/connectors/{connectorId}`
* `POST /v1/workspaces/{workspaceId}/connectors/{connectorId}/activate`

## Uso esperado

1. listar catalogo
2. instalar conector
3. ativar instalação
4. refletir o status operacional na area de trabalho

## Observação

O portal publico deve documentar conectores como superficie operacional, nao como lista abstrata de tipos.