# Health check

Check whether the knowledge connector service is reachable.

## Public health check

Returns the availability status of the connector service. This endpoint does not require authentication.

## Organization-scoped health check

Returns the availability status of the connector service for a specific organization. Requires authentication.

#### Path Parameters

**`organization_id`** string required

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

## Returns

An object with `status` (string) and `available` (boolean).

Request

```bash cURL — Public
curl "https://api.aitronos.com/v1/knowledge/connectors/health"
```


```bash cURL — Org-scoped
curl "https://api.aitronos.com/v1/organizations/org_xyz789/knowledge/connectors/health" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```


```python Python SDK
from aitronos import Aitronos

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

# Public health check
result = client.knowledge_connectors.health()
print(result)

# Organization-scoped health check
result = client.knowledge_connectors.health(
    organization_id="org_xyz789",
)
print(result)
```


```python Python
import requests

# Public health check
url = "https://api.aitronos.com/v1/knowledge/connectors/health"
response = requests.get(url)
print(response.json())

# Organization-scoped health check
org_id = "org_xyz789"
url = f"https://api.aitronos.com/v1/organizations/{org_id}/knowledge/connectors/health"
headers = {"Authorization": "Bearer YOUR_ACCESS_TOKEN"}
response = requests.get(url, headers=headers)
print(response.json())
```


```javascript JavaScript
// Public health check
const response = await fetch(
  "https://api.aitronos.com/v1/knowledge/connectors/health"
);
const data = await response.json();
console.log(data);

// Organization-scoped health check
const orgResponse = await fetch(
  "https://api.aitronos.com/v1/organizations/org_xyz789/knowledge/connectors/health",
  {
    headers: { Authorization: "Bearer YOUR_ACCESS_TOKEN" },
  }
);
const orgData = await orgResponse.json();
console.log(orgData);
```

Response

```json 200 OK
{
  "status": "ok",
  "available": true
}
```


```json Service unavailable
{
  "status": "unavailable",
  "available": false
}
```

## Related Resources

- [Workspaces](/docs/api-reference/knowledge-connectors/workspaces)
- [Sources](/docs/api-reference/knowledge-connectors/sources)