1. API
  2. AI providers

AI providers: List

Last updated Open markdown version

Description

Retrieve the AI providers and models available to the authenticated user.

Admins receive all AI providers configured for the tenant. Non-admin users receive providers owned by one of their teams, shared with one of their teams, or available to the entire tenant. The response includes enabled and disabled providers.

Request

HTTP Method: GET

curl -X GET \
  https://<tenant-domain>/api/v1/ai_providers \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>'

Response

A successful request returns a JSON object containing an array of AI providers. Each provider includes the models that can be selected when configuring Tines AI features.

Field description

Parameter Description
ai_providers Array of AI provider objects visible to the authenticated user.
guid Unique identifier of the AI provider.
enabled Whether the AI provider is enabled.
name The configured name of the AI provider, or its default provider name when no custom name is set.
provider_type Provider service. One of ANTHROPIC, OPEN_AI, AWS_BEDROCK, ORACLE_COHERE, MISTRAL, or GOOGLE_VERTEX.
provisioning_type How the provider is provisioned. One of customer_provisioned or tines_provisioned.
models Array of models available through the provider.
display_name Display name of the model.
api_model_id Model identifier used when configuring Tines AI features through the API.
description Description of the model, or null when no description is available.
cost_tier Relative model cost. One of LOW, MEDIUM, or HIGH, or null when no cost tier is available.
legacy Whether the model is a legacy model.

Sample response

{
  "ai_providers": [
    {
      "guid": "2c6c29e7-0f57-42b6-b7f7-663a45299f69",
      "enabled": true,
      "name": "My Anthropic",
      "provider_type": "ANTHROPIC",
      "provisioning_type": "customer_provisioned",
      "models": [
        {
          "display_name": "Sonnet 5",
          "api_model_id": "claude-sonnet-5",
          "description": "Best combination of speed and intelligence for a wide range of tasks",
          "cost_tier": "MEDIUM",
          "legacy": false
        }
      ]
    }
  ]
}
Was this helpful?