Chat Endpoints

___________________________________________________________________________________________________________

POST /api/v1/chat

This endpoint processes natural language queries and returns responses from the configured OpenAI model.

Request Body:

{
  "user_id": "user123",
  "session_id": "session123",
  "chat_data": {
    "messages": [
      {
        "role": "user",
        "content": "Your query here"
      }
    ]
  }
}

Response:

• A streaming response that returns the conversation or information from the agent.

Usage Example:

curl --request POST \
  --url http://localhost:8000/api/v1/chat \
  --header 'Content-Type: application/json' \
  --data '{
    "user_id": "user123",
    "session_id": "session123",
    "chat_data": {
        "messages": [
            { "role": "user", "content": "What is the capital of France?" }
        ]
    }
  }'

GET /api/v1/chat_history

This endpoint retrieves the chat history for a specified user and session.

Query Parameters:

• user_id: The user ID.

• session_id: The session ID.

Response:

• A JSON array of the chat history.

Usage Example:

curl --request GET \
  --url 'http://localhost:8000/api/v1/chat_history?user_id=user123&session_id=session123'

Database Endpoints

___________________________________________________________________________________________________________

Ensure you set the HIVE_AGENT_DATABASE_URL environment variable.

POST /api/v1/database/create-table

This endpoint creates a new table in the database.

Request Body:

{
  "table_name": "your_table_name",
  "columns": {
    "column1": "type1",
    "column2": "type2"
  }
}

Response:

• A JSON object indicating the success of the table creation.

Usage Example:

curl --request POST \
  --url http://localhost:8000/api/v1/database/create-table \
  --header 'Content-Type: application/json' \
  --data '{"table_name": "example_table", "columns": {"id": "INTEGER PRIMARY KEY", "name": "TEXT"}}'

POST /api/v1/database/insert-data

This endpoint inserts data into a specified table.

Request Body:

{
  "table_name": "your_table_name",
  "data": {
    "column1": "value1",
    "column2": "value2"
  }
}

Response:

• A JSON object indicating the success of the data insertion and the ID of the inserted record.

Usage Example:

curl --request POST \
  --url http://localhost:8000/api/v1/database/insert-data \
  --header 'Content-Type: application/json' \
  --data '{"table_name": "example_table", "data": {"name": "John Doe"}}'

POST /api/v1/database/read-data

This endpoint reads data from a specified table based on given filters.

Request Body:

{
  "table_name": "your_table_name",
  "filters": {
    "column": "value"
  }
}

Response:

• A JSON array of the matching records.

Usage Example:

curl --request POST \
  --url http://localhost:8000/api/v1/database/read-data \
  --header 'Content-Type: application/json' \
  --data '{"table_name": "example_table", "filters": {"name": "John Doe"}}'

PUT /api/v1/database/update-data

This endpoint updates data in a specified table.

Request Body:

{
  "table_name": "your_table_name",
  "id": "record_id",
  "data": {
    "column": "new_value"
  }
}

Response:

• A JSON object indicating the success of the data update.

Usage Example:

curl --request PUT \
  --url http://localhost:8000/api/v1/database/update-data \
  --header 'Content-Type: application/json' \
  --data '{"table_name": "example_table", "id": 1, "data": {"name": "Jane Doe"}}'

DELETE /api/v1/database/delete-data

This endpoint deletes data from a specified table.

Request Body:

{
  "table_name": "your_table_name",
  "id": "record_id"
}

Response:

• A JSON object indicating the success of the data deletion.

Usage Example:

curl --request DELETE \
  --url http://localhost:8000/api/v1/database/delete-data \
  --header 'Content-Type: application/json' \
  --data '{"table_name": "example_table", "id": 1}'

These endpoints provide the foundation for interacting with the Hive Agent, allowing for both real-time and persistent data handling, as well as dynamic interaction via chat and database operations.

File Management Endpoints

___________________________________________________________________________________________________________

POST /api/v1/uploadfiles/

This endpoint allows you to upload one or more files to the server.

Request:

• Multipart form data containing files.

Response:

• A JSON object with the names of the uploaded files.

Usage Example:

curl --request POST \
  --url http://localhost:8000/api/v1/uploadfiles/ \
  --header 'Content-Type: multipart/form-data' \
  --form 'files=@path/to/your/file1.txt' \
  --form 'files=@path/to/your/file2.txt'

GET /api/v1/files/

This endpoint lists all files stored on the server.

Response:

• A JSON object containing a list of file names.

Usage Example:

curl --request GET \
  --url

PUT /api/v1/files/{old_filename}/{new_filename}

This endpoint renames a specified file on the server.

URL Parameters:

• old_filename: The current name of the file.

• new_filename: The new name for the file.

Response:

• A JSON object indicating the success of the file renaming.

Usage Example:

curl --request PUT \
  --url

DELETE /api/v1/files/{filename}

This endpoint deletes a specified file from the server.

URL Parameters:

• filename: The name of the file to be deleted.

Response:

• A JSON object indicating the success of the file deletion.

Usage Example:

curl --request DELETE \
  --url