# Connector versions

List available connector versions and upgrade sources to new versions.

## List connector versions

Returns all available versions for a connector definition.

#### Path Parameters

**`organization_id`** string required

The unique identifier of the organization (format: `org_*`).

**`definition_id`** string required

The actor definition ID to list versions for.

## Upgrade source

Upgrade a source connector to a new version.

#### Path Parameters

**`source_id`** string required

The source ID to upgrade.

#### Request Body

**`target_version`** string required

Docker image tag for the target connector version.

## Returns

For list versions: an array of version objects containing `actor_definition_id`, `docker_repository`, `docker_image_tag`, `is_version_override`, and `support_state`.

For upgrade: the updated source object with the new version applied.

Request

```bash cURL — List versions
curl "https://api.aitronos.com/v1/organizations/org_xyz789/knowledge/connectors/source-definitions/def_abc123/versions" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```


```bash cURL — Upgrade source
curl -X POST "https://api.aitronos.com/v1/organizations/org_xyz789/knowledge/connectors/sources/src_abc123/upgrade" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target_version": "2.0.0"}'
```


```python Python SDK
from aitronos import Aitronos

client = Aitronos(api_key="your-api-key")

# List versions
versions = client.knowledge_connectors.list_connector_versions(
    organization_id="org_xyz789",
    definition_id="def_abc123",
)
print(versions)

# Upgrade source
result = client.knowledge_connectors.upgrade_source(
    organization_id="org_xyz789",
    source_id="src_abc123",
    target_version="2.0.0",
)
print(result)
```


```python Python
import requests

org_id = "org_xyz789"
headers = {"Authorization": "Bearer YOUR_ACCESS_TOKEN"}

# List versions
url = f"https://api.aitronos.com/v1/organizations/{org_id}/knowledge/connectors/source-definitions/def_abc123/versions"
response = requests.get(url, headers=headers)
print(response.json())

# Upgrade source
url = f"https://api.aitronos.com/v1/organizations/{org_id}/knowledge/connectors/sources/src_abc123/upgrade"
response = requests.post(url, headers=headers, json={"target_version": "2.0.0"})
print(response.json())
```


```javascript JavaScript
const headers = { Authorization: "Bearer YOUR_ACCESS_TOKEN" };

// List versions
const versionsRes = await fetch(
  "https://api.aitronos.com/v1/organizations/org_xyz789/knowledge/connectors/source-definitions/def_abc123/versions",
  { headers }
);
console.log(await versionsRes.json());

// Upgrade source
const upgradeRes = await fetch(
  "https://api.aitronos.com/v1/organizations/org_xyz789/knowledge/connectors/sources/src_abc123/upgrade",
  {
    method: "POST",
    headers: { ...headers, "Content-Type": "application/json" },
    body: JSON.stringify({ target_version: "2.0.0" }),
  }
);
console.log(await upgradeRes.json());
```

Response

```json 200 OK — List versions
{
  "data": [
    {
      "actor_definition_id": "def_abc123",
      "docker_repository": "aitronos/source-postgres",
      "docker_image_tag": "2.0.0",
      "is_version_override": false,
      "support_state": "supported"
    },
    {
      "actor_definition_id": "def_abc123",
      "docker_repository": "aitronos/source-postgres",
      "docker_image_tag": "1.5.0",
      "is_version_override": false,
      "support_state": "supported"
    }
  ]
}
```


```json 200 OK — Upgrade source
{
  "source_id": "src_abc123",
  "name": "Production Database",
  "status": "upgraded"
}
```


```json 4xx Error
{
  "success": false,
  "error": {
    "code": "CONNECTOR_SOURCE_NOT_FOUND",
    "message": "The requested source was not found.",
    "type": "client_error",
    "status": 404,
    "details": {},
    "trace_id": "abc-123-def",
    "timestamp": "2025-12-22T15:30:00Z"
  }
}
```

## Related Resources

- [Source Definitions](/docs/api-reference/knowledge-connectors/source-definitions)
- [Sources](/docs/api-reference/knowledge-connectors/sources)
- [Destination Definitions](/docs/api-reference/knowledge-connectors/destination-definitions)
- [Declarative Sources](/docs/api-reference/knowledge-connectors/declarative-sources)