get__ai_llm_available

⚠️ TEST ENVIRONMENT ONLY

This API endpoint is currently available only in the TEST environment. It is not yet available in production.

GET /ai/llm/available

Get Available AI LLM Configurations

Retrieve all AI/LLM provider configurations that are available for use. This endpoint returns configurations that can be associated with repositories or used for AI-powered features.

Key Differences from GET /ai/llm:

  • This endpoint returns only configurations that are available and ready for use

  • Configurations must be validated and active

  • Useful for selecting AI providers when creating or updating repositories

Use Cases:

  • Populate dropdown lists when configuring repositories

  • Display available AI options to users

  • Verify which AI providers are configured and accessible

Important Notes:

  • API secrets are never returned in responses (only masked/null values)

  • Results are filtered based on workspace access permissions

  • Configurations are sorted by creation date (newest first)

TypeScript Client Library

public getAvailableAiLlms = async (): Promise<GetAiLlmsResponse> => {
  return this.makeRequest<GetAiLlmsResponse>('ai/llm/available', 'GET', null);
};

Code Samples

# You can also use wget
curl -X GET https://backend.flashback.tech/ai/llm/available \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

Parameters

This endpoint does not require any parameters.

Example responses

200 Response

{
  "success": true,
  "aiLlms": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "orgId": "org-123",
      "workspaceId": "workspace-123",
      "userId": "user-456",
      "name": "Production OpenAI",
      "aiType": "OPENAI",
      "endpoint": "https://api.openai.com/v1",
      "key": null,
      "createdAt": "2024-01-15T10:30:00.000Z",
      "repos": []
    },
    {
      "id": "660f9511-f3ac-52e5-b827-557766551111",
      "orgId": "org-123",
      "workspaceId": "workspace-123",
      "userId": "user-456",
      "name": "Anthropic Claude",
      "aiType": "ANTHROPIC",
      "endpoint": "https://api.anthropic.com/v1",
      "key": null,
      "createdAt": "2024-01-14T08:20:00.000Z",
      "repos": [
        {
          "id": "repo-789",
          "name": "ai-repo",
          "createdAt": "2024-01-16T08:00:00.000Z"
        }
      ]
    }
  ]
}

Responses

Status
Meaning
Description
Schema

200

Successfully retrieved available configurations

Inline

403

Insufficient permissions

Inline

500

Failed to retrieve configurations

Inline

Response Schema

Status Code 200

Name
Type
Required
Restrictions
Description

» success

boolean

false

none

Operation success status

» aiLlms

[object]

false

none

Array of available AI LLM configurations

»» id

string

false

none

Unique identifier for the configuration

»» orgId

string

false

none

Organization ID

»» workspaceId

string

false

none

Workspace ID

»» userId

string

false

none

User ID who created the configuration

»» name

string

false

none

Configuration name

»» aiType

string

false

none

AI provider type (OPENAI, GOOGLE, etc.)

»» endpoint

string

false

none

API endpoint URL

»» key

string

false

none

Access key (always null for security)

»» createdAt

string

false

none

ISO 8601 timestamp

»» repos

[object]

false

none

Associated repositories (optional)

»»» id

string

false

none

Repository ID

»»» name

string

false

none

Repository name

»»» createdAt

string

false

none

Repository creation timestamp

Status Code 403

Name
Type
Required
Restrictions
Description

» success

boolean

false

none

none

» message

string

false

none

none

Status Code 500

Name
Type
Required
Restrictions
Description

» success

boolean

false

none

none

» message

string

false

none

none

To perform this operation, you must be authenticated by means of one of the following methods: BearerAuth

Last updated

Was this helpful?