Providers

Configure and manage AI provider connections.

List Providers

Endpoint

GET /v1/management/providers

Example

curl https://api.gateflow.ai/v1/management/providers \
  -H "Authorization: Bearer gw_admin_..."

Response

{
  "providers": [
    {
      "id": "openai",
      "name": "OpenAI",
      "status": "active",
      "configured": true,
      "models": ["gpt-5.2", "gpt-5", "gpt-5-mini", "text-embedding-3-large"],
      "health": {
        "status": "healthy",
        "latency_ms": 120,
        "last_check": "2026-02-16T10:00:00Z"
      }
    },
    {
      "id": "anthropic",
      "name": "Anthropic",
      "status": "active",
      "configured": true,
      "models": ["claude-opus-4-5-20251107", "claude-sonnet-4-5-20250929", "claude-haiku-4-5-20251015"],
      "health": {
        "status": "healthy",
        "latency_ms": 95,
        "last_check": "2026-02-16T10:00:00Z"
      }
    },
    {
      "id": "google",
      "name": "Google AI",
      "status": "inactive",
      "configured": false,
      "models": [],
      "health": null
    }
  ]
}

Configure Provider

Endpoint

POST /v1/management/providers

Request Body

Parameter	Type	Required	Description
provider	string	Yes	Provider ID
credentials	object	Yes	Provider-specific credentials
settings	object	No	Provider settings

Examples

OpenAI

curl -X POST https://api.gateflow.ai/v1/management/providers \
  -H "Authorization: Bearer gw_admin_..." \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "openai",
    "credentials": {
      "api_key": "sk-..."
    },
    "settings": {
      "organization_id": "org-...",
      "default_model": "gpt-5.2"
    }
  }'

Anthropic

curl -X POST https://api.gateflow.ai/v1/management/providers \
  -H "Authorization: Bearer gw_admin_..." \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "anthropic",
    "credentials": {
      "api_key": "sk-ant-..."
    },
    "settings": {
      "default_model": "claude-sonnet-4-5-20250929"
    }
  }'

Google AI

curl -X POST https://api.gateflow.ai/v1/management/providers \
  -H "Authorization: Bearer gw_admin_..." \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "google",
    "credentials": {
      "api_key": "..."
    },
    "settings": {
      "default_model": "gemini-3-pro"
    }
  }'

Mistral

curl -X POST https://api.gateflow.ai/v1/management/providers \
  -H "Authorization: Bearer gw_admin_..." \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "mistral",
    "credentials": {
      "api_key": "..."
    }
  }'

Cohere

curl -X POST https://api.gateflow.ai/v1/management/providers \
  -H "Authorization: Bearer gw_admin_..." \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "cohere",
    "credentials": {
      "api_key": "..."
    }
  }'

ElevenLabs

curl -X POST https://api.gateflow.ai/v1/management/providers \
  -H "Authorization: Bearer gw_admin_..." \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "elevenlabs",
    "credentials": {
      "api_key": "..."
    },
    "settings": {
      "default_voice": "rachel"
    }
  }'

Response

{
  "id": "openai",
  "name": "OpenAI",
  "status": "active",
  "configured": true,
  "configured_at": "2026-02-16T10:00:00Z",
  "models": ["gpt-5.2", "gpt-5", "gpt-5-mini", "text-embedding-3-large"]
}

Get Provider Details

Endpoint

GET /v1/management/providers/{provider_id}

Example

curl https://api.gateflow.ai/v1/management/providers/openai \
  -H "Authorization: Bearer gw_admin_..."

Response

{
  "id": "openai",
  "name": "OpenAI",
  "status": "active",
  "configured": true,
  "configured_at": "2026-02-16T10:00:00Z",
  "settings": {
    "organization_id": "org-...",
    "default_model": "gpt-5.2"
  },
  "models": [
    {"id": "gpt-5.2", "type": "chat", "available": true},
    {"id": "gpt-5", "type": "chat", "available": true},
    {"id": "gpt-5-mini", "type": "chat", "available": true},
    {"id": "text-embedding-3-large", "type": "embedding", "available": true}
  ],
  "health": {
    "status": "healthy",
    "latency_ms": 120,
    "uptime_30d": 0.9995,
    "last_check": "2026-02-16T10:00:00Z",
    "last_error": null
  },
  "usage": {
    "requests_today": 5000,
    "tokens_today": 2500000,
    "cost_today_usd": 25.00
  }
}

Update Provider

Endpoint

PATCH /v1/management/providers/{provider_id}

Example

curl -X PATCH https://api.gateflow.ai/v1/management/providers/openai \
  -H "Authorization: Bearer gw_admin_..." \
  -H "Content-Type: application/json" \
  -d '{
    "settings": {
      "default_model": "gpt-5-mini"
    }
  }'

Update Provider Credentials

Endpoint

POST /v1/management/providers/{provider_id}/credentials

Example

curl -X POST https://api.gateflow.ai/v1/management/providers/openai/credentials \
  -H "Authorization: Bearer gw_admin_..." \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "sk-new-key-..."
  }'

Response

{
  "id": "openai",
  "credentials_updated_at": "2026-02-16T10:30:00Z",
  "status": "active"
}

Test Provider Connection

Endpoint

POST /v1/management/providers/{provider_id}/test

Example

curl -X POST https://api.gateflow.ai/v1/management/providers/openai/test \
  -H "Authorization: Bearer gw_admin_..."

Response

{
  "id": "openai",
  "test_result": "success",
  "latency_ms": 145,
  "models_available": 12,
  "tested_at": "2026-02-16T10:00:00Z"
}

Disable Provider

Endpoint

POST /v1/management/providers/{provider_id}/disable

Example

curl -X POST https://api.gateflow.ai/v1/management/providers/openai/disable \
  -H "Authorization: Bearer gw_admin_..."

Response

{
  "id": "openai",
  "status": "disabled",
  "disabled_at": "2026-02-16T10:00:00Z"
}

Enable Provider

Endpoint

POST /v1/management/providers/{provider_id}/enable

Example

curl -X POST https://api.gateflow.ai/v1/management/providers/openai/enable \
  -H "Authorization: Bearer gw_admin_..."

Delete Provider Configuration

Endpoint

DELETE /v1/management/providers/{provider_id}

Example

curl -X DELETE https://api.gateflow.ai/v1/management/providers/openai \
  -H "Authorization: Bearer gw_admin_..."

Supported Providers

Provider	ID	Models
OpenAI	openai	GPT-5 series, embeddings, TTS, Whisper
Anthropic	anthropic	Claude 4.5 series
Google	google	Gemini 3 series
Mistral	mistral	Large, Small, Voxtral, Devstral
Cohere	cohere	Command R+, Rerank
ElevenLabs	elevenlabs	TTS models

Errors

Code	Description
400	Invalid configuration
401	Invalid admin key
403	Insufficient permissions
404	Provider not found
422	Invalid credentials

See Also

• Provider Configuration - Setup guide
• Intelligent Routing - Routing configuration
• Model Fallbacks - Fallback setup