Humile API Reference

Overview

The Humile API provides endpoints for response normalization and translation services in the TKM AI Agency Platform. It ensures consistent communication across different languages and formats.

Endpoints

Get Normalized Response

GET /get_response/{conversation_id}

Retrieves a normalized response for a specific conversation.

Path Parameters

Name	Type	Required	Description
`conversation_id`	string	Yes	The conversation ID

Query Parameters

Name	Type	Required	Description
`user_id`	string	Yes	The user ID
`organization_id`	string	No	The organization ID

Response

{
    "success": true,
    "message": "string",
    "metadata": {
        "additional": "data"
    }
}

Error Responses

404 Not Found

{
    "detail": "No normalized response found"
}

500 Internal Server Error

{
    "detail": "Error message"
}

Integration Notes

Response Features

Message normalization
Language translation
Format standardization
Context preservation

Conversation Management

Conversation tracking
User context
Organization isolation
Response history

Error Handling

Detailed error reporting
Response validation
Context verification
Fallback handling

Integration with Other Agents

Atta: Conversation context
Prometheus: Response generation
Carina: Search responses

Carina Lyra