List API Versions

List available API versions.

Endpoint

GET /versions

API Request

• Parameters

  ---

  No parameters.

• GET /versions

  ---

  cURLAI PromptC#GoJavaNode.jsPHPPythonRuby

  curl "https://api.gainly.ai/versions" \
    -H "Content-Type: application/json" \
    -H "X-API-Key: YOUR_API_KEY_HERE"  # (1)!
  

  1. Replace YOUR_API_KEY_HERE with the value of your API key.

  # Prompt for AI coding assistants/IDEs (e.g., ChatGPT, Claude, GitHub Copilot, Cursor, Windsurf)
  
  Using the Gainly API:
  1. Write code to call the list_api_versions operation (see OpenAPI spec: https://api.gainly.ai/v20241104/openapi.json)
  2. Implement authentication using the header "X-API-Key" as described in the docs: https://docs.gainly.ai/latest/api-reference/authentication/
  3. Implement rate limit handling as described in the docs: https://docs.gainly.ai/latest/api-reference/rate-limits/
  4. Implement error handling
  5. Handle the response according to the ListApiVersionsResults schema in the OpenAPI spec
  

  using System.Net.Http;
  using System.Text.Json;
  
  var client = new HttpClient();
  
  var url = "https://api.gainly.ai/versions";
  
  client.DefaultRequestHeaders.Add("X-API-Key", "YOUR_API_KEY_HERE"); // (1)!
  
  var response = await client.GetAsync(url);
  var result = await response.Content.ReadAsStringAsync();
  Console.WriteLine(result);
  

  1. Replace YOUR_API_KEY_HERE with the value of your API key.

  package main
  
  import (
      "encoding/json"
      "fmt"
      "net/http"
  )
  
  func main() {
      url := "https://api.gainly.ai/versions"
  
      req, _ := http.NewRequest("GET", url, nil)
      req.Header.Set("Content-Type", "application/json")
      req.Header.Set("X-API-Key", "YOUR_API_KEY_HERE") // (1)!
  
      resp, _ := http.DefaultClient.Do(req)
      defer resp.Body.Close()
  
      var result map[string]interface{}
      json.NewDecoder(resp.Body).Decode(&result)
      fmt.Println(result)
  }
  

  1. Replace YOUR_API_KEY_HERE with the value of your API key.

  import java.net.http.HttpClient;
  import java.net.http.HttpRequest;
  import java.net.http.HttpResponse;
  import java.net.URI;
  
  var client = HttpClient.newHttpClient();
  
  var url = "https://api.gainly.ai/versions";
  
  var request = HttpRequest.newBuilder()
      .uri(URI.create(url))
      .header("Content-Type", "application/json")
      .header("X-API-Key", "YOUR_API_KEY_HERE") // (1)!
      .GET()
      .build();
  
  var response = client.send(request, HttpResponse.BodyHandlers.ofString());
  System.out.println(response.body());
  

  1. Replace YOUR_API_KEY_HERE with the value of your API key.

  const axios = require('axios');  // or: import axios from 'axios';
  
  const url = 'https://api.gainly.ai/versions';
  
  const headers = {
      'Content-Type': 'application/json',
      'X-API-Key': 'YOUR_API_KEY_HERE' // (1)!
  };
  
  axios.get(url, { headers })
      .then(response => console.log(response.data))
      .catch(error => console.error('Error:', error.message));
  

  1. Replace YOUR_API_KEY_HERE with the value of your API key.

  <?php
  
  $client = new \GuzzleHttp\Client();
  
  $url = 'https://api.gainly.ai/versions';
  
  $response = $client->request('GET', $url, [
      'headers' => [
          'Content-Type' => 'application/json',
          'X-API-Key' => 'YOUR_API_KEY_HERE' # (1)!
      ],
  ]);
  
  echo $response->getBody();
  

  1. Replace YOUR_API_KEY_HERE with the value of your API key.

  import requests
  
  url = "https://api.gainly.ai/versions"
  
  headers = {
      "Content-Type": "application/json",
      "X-API-Key": "YOUR_API_KEY_HERE" # (1)!
  }
  
  response = requests.get(url, headers=headers)
  data = response.json()
  print(data)
  

  1. Replace YOUR_API_KEY_HERE with the value of your API key.

  require 'json'
  require 'uri'
  require 'net/http'
  require 'openssl'
  
  url = URI('https://api.gainly.ai/versions')
  
  http = Net::HTTP.new(url.host, url.port)
  http.use_ssl = true
  
  request = Net::HTTP::Get.new(url)
  request['Content-Type'] = 'application/json'
  request['X-API-Key'] = 'YOUR_API_KEY_HERE' # (1)!
  
  response = http.request(request)
  puts response.read_body
  

  1. Replace YOUR_API_KEY_HERE with the value of your API key.

API Response

{
    "object": "api_versions_result",
    "url": "/versions",
    "versions": [
        {
            "version": "v20240919",
            "status": "latest"
        },
        {
            "version": "v20240812"
        }
    ]
}

status property can have these values:

• latest
• deprecated