Listar Provedores de Credenciais

Listar os métodos de conexão OAuth e de conta de serviço catalogados e se cada um está disponível para quem faz a chamada neste workspace e neste deployment. Opcionalmente, busque nomes de provedores por correspondência de substring sem diferenciar maiúsculas de minúsculas. As opções de autorização OAuth contêm os IDs de provedor exatos aceitos pelo endpoint de conexão no navegador; os métodos de conta de serviço listam os campos exatos do body de criação e marcam os campos secretos como somente escrita. O conjunto limitado é retornado em uma única página; nextCursor é sempre null.

GET/api/v2/credentials/providers

Authorization

X-API-Key<token>

Sua API key do Studio, pessoal ou com escopo de workspace. Gere uma em Settings e depois API Keys. As operações que rejeitam API keys de workspace dizem isso na própria descrição.

Em: header

Parâmetros de query

workspaceId*string

Workspace usado para avaliar a disponibilidade de provedores de credencial e a política de integração.

Tamanho1 <= length <= 128
search?string

Correspondência de substring com o nome do provedor da credencial, sem diferenciar maiúsculas de minúsculas.

Tamanho1 <= length <= 200

Corpo da resposta

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://agent-studio.seeyu.ai/api/v2/credentials/providers?workspaceId=string" \  -H "X-API-Key: YOUR_API_KEY"
{
  "data": [
    {
      "type": "oauth",
      "serviceId": "salesforce",
      "name": "Salesforce",
      "description": "Conectar aos dados e às operações do Salesforce CRM.",
      "providerFamily": "salesforce",
      "available": true,
      "supportsReconnect": true,
      "fields": [],
      "authorizationOptions": [
        {
          "providerId": "salesforce",
          "label": "Production"
        },
        {
          "providerId": "salesforce-sandbox",
          "label": "Sandbox"
        }
      ]
    },
    {
      "type": "service_account",
      "serviceId": "zoom-service-account",
      "providerId": "zoom-service-account",
      "name": "Zoom server-to-server app",
      "description": "Conectar o Zoom com um app server-to-server.",
      "providerFamily": "zoom",
      "available": true,
      "docsUrl": "https://docs.seeyu.ai/integrations/zoom-service-account",
      "requiresClientGeneratedCredentialId": false,
      "fields": [
        {
          "id": "clientId",
          "label": "Client ID",
          "placeholder": "Paste the client ID",
          "required": true,
          "secret": false,
          "multiline": false
        },
        {
          "id": "clientSecret",
          "label": "Client secret",
          "placeholder": "Paste the client secret",
          "required": true,
          "secret": true,
          "multiline": false
        },
        {
          "id": "orgId",
          "label": "Account ID",
          "placeholder": "Paste the account ID",
          "required": true,
          "secret": false,
          "multiline": false
        }
      ]
    }
  ],
  "nextCursor": null
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Invalid request"
  }
}
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required"
  }
}
{
  "error": {
    "code": "FORBIDDEN",
    "message": "Insufficient workspace permissions",
    "details": {
      "code": "INSUFFICIENT_WORKSPACE_ROLE"
    }
  }
}
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Not found"
  }
}
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "API rate limit exceeded",
    "details": {
      "retryAfter": "2026-01-01T00:00:30.000Z"
    }
  }
}
{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error"
  }
}
{
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "Service temporarily unavailable"
  }
}
DELETEDesconectar CredencialGETListar Credenciais