Skip to main content
GET
Listar conexões de um projeto

Autenticação

Este endpoint aceita dois formatos de autenticação:
  1. JWT da plataforma
    • Header: Authorization: Bearer {jwt}
  2. API Key do Metrito
    • Header: Authorization: Bearer mtk_live_... ou x-api-key: mtk_live_...
    • Requer escopo data:read
    • O projeto deve pertencer ao workspace vinculado à chave

Autorizações

Authorization
string
header
obrigatório

JWT da plataforma ou API key mtk_live_... enviada no header Authorization

Parâmetros de caminho

project_id
string
obrigatório

ID do projeto.

Exemplo:

"69162064162b926ae607959b"

Resposta

Lista de conexões retornada com sucesso

id
string

ID da conexão

source
string

Nome da fonte de dados (Meta Ads, Google Ads, TikTok Ads, Personalizado, etc.)

source_id
string | null

ID da conta na plataforma de origem (ex. act_123456 para Meta)

name
string

Nome dado à conexão pelo usuário

status
enum<string>

Status atual da conexão

Opções disponíveis:
active,
error,
paused,
disabled
workspace_id
string

ID do workspace

webhook_url
string | null

URL do webhook (apenas para conexões do tipo Personalizado)