Skip to content
Last updated
🔨 In Development — This section is still being developed and may change.
POST/v1/pipeline/health/validate

Validate pipeline connector configuration including vector store, organization, and API key.

Authentication: Pipeline Connector API Key required (X-API-Key header)

organization_id string required

Organization ID to validate.

vector_store_id string optional

Specific vector store ID to validate.

Validation Checks

  • API key authentication
  • Organization exists
  • Vector store record (if vector_store_id provided)
  • Vector store service connectivity
  • Collection initialization for organization

Returns

Returns detailed validation results for each component with status and timestamp.

cURL
curl -X POST "https://api.aitronos.com/v1/pipeline/health/validate?organization_id=org_abc123&vector_store_id=vs_xyz789" \
  -H "X-API-Key: $PIPELINE_API_KEY"

Response

{
  "status": "valid",
  "checks": {
    "api_key": {
      "valid": true,
      "message": "API key authenticated"
    },
    "organization": {
      "valid": true,
      "message": "Organization exists",
      "organization_id": "org_abc123"
    },
    "vector_store_record": {
      "valid": true,
      "message": "Vector store exists and is active",
      "vector_store_id": "vs_xyz789",
      "vector_store_name": "My Vector Store",
      "access_mode": "organization"
    },
    "vector_store": {
      "valid": true,
      "message": "Vector store connection healthy"
    },
    "collection": {
      "valid": true,
      "message": "Collection initialized",
      "collection_name": "freddy_org_abc123"
    }
  },
  "timestamp": "2026-01-12T10:30:00Z"
}

Error Responses

400 Validation Failed

{
  "success": false,
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "Configuration validation failed",
    "details": {
      "checks": {
        "api_key": {"valid": true},
        "organization": {
          "valid": false,
          "error": "Organization not found"
        }
      }
    }
  }
}