Skip to main content

Knowledge Sources API Reference

Overview​

The Knowledge Sources API allows you to connect, manage, and query various knowledge sources in Gentic.

Endpoints​

List Knowledge Sources​

GET /knowledge-sources

Returns a list of all knowledge sources.

Create Knowledge Source​

POST /knowledge-sources

Creates a new knowledge source.

Get Knowledge Source​

GET /knowledge-sources/{sourceId}

Retrieves details of a specific knowledge source.

Update Knowledge Source​

PUT /knowledge-sources/{sourceId}

Updates an existing knowledge source.

Delete Knowledge Source​

DELETE /knowledge-sources/{sourceId}

Deletes a knowledge source.

Connect Knowledge Source​

POST /knowledge-sources/{sourceId}/connect

Establishes connection to a knowledge source.

Request/Response Examples​

Create Knowledge Source​

{
  "name": "Product Database",
  "type": "postgresql",
  "config": {
    "host": "localhost",
    "port": 5432,
    "database": "products",
    "table": "inventory"
  }
}

Connect Knowledge Source​

{
  "credentials": {
    "username": "admin",
    "password": "secret"
  },
  "options": {
    "sync": true,
    "index": true
  }
}

Error Codes​

  • 400: Bad Request
  • 401: Unauthorized
  • 403: Forbidden
  • 404: Not Found
  • 429: Too Many Requests
  • 500: Internal Server Error

Rate Limits​

  • 50 requests per minute per API key
  • 500 requests per hour per API key

Next Steps​