Skip to main content
This documentation provides comprehensive details about all available endpoints, request parameters, and response formats for the Covita v0.2 API.

​
🌐 Base URL

All API endpoints are relative to the base URL: https://covita.nivara.io

​
🔐 Authentication

New in v0.2: Covita now implements a whitelisted login system for enhanced security.

All API requests require an authorization token which is provided to whitelisted users.

Contact the administration team to get your user credentials added to the whitelist.

​
🤖 Chatbot API

The Chatbot API provides the following endpoints:

​
Send Message

POST /v1/send_message Sends a message to the chatbot and receives a response. Request Parameters:
  • text (string, required): The message text
  • user_id (string, optional, default: “User1”): User identifier, one of: “User1” through “User20”
  • user_type (string, optional, default: “Patient”): User type, one of: “Patient”, “Doctor”, “Coach”
  • model_id (string, optional, default: “openai”): Model to use, one of: “openai”, “gemini”

​
Get Conversation History

GET /v1/conversation_history Retrieves the conversation history for a given user type. Query Parameters:
  • user_type (string, required): User type
  • model_id (string, required): Model ID
  • user_id (string, required): User identifier

​
Reset Conversation History

GET /v1/reset_conversation_history Resets the conversation history for a given user type. Query Parameters:
  • user_type (string, required): User type
  • model_id (string, required): Model ID
  • user_id (string, required): User identifier

​
⚠️ Error Handling

The API uses standard HTTP status codes to indicate the success or failure of requests.
Status CodeDescription
200Success
201Created
400Bad Request
401Unauthorized
403Forbidden
404Not Found
422Validation Error
500Server Error
When an error occurs, the response will include details about what went wrong in a standardized format.
{
  "error": {
    "code": "error_code",
    "message": "A descriptive error message",
    "details": {
      // Additional error details if available
    }
  }
}