Carina API Reference

Overview

The Carina API provides endpoints for managing search operations and retrieving search results in the TKM AI Agency Platform. It handles search history and result management.

Base URL

/carina

Endpoints

Get Search Results

GET /carina/search-results

Retrieves historical search results for a user within an organization.

Query Parameters

Name	Type	Required	Description
`auth0_id`	string	Yes	The user ID
`organization_id`	string	Yes	The organization ID
`from_date`	string (ISO datetime)	No	Filter results from this date
`to_date`	string (ISO datetime)	No	Filter results until this date

Response

[
    {
        "id": "string",
        "auth0_id": "string",
        "organization_id": "string",
        "results": {
            "search_data": "object"
        },
        "created_at": "2024-01-20T12:00:00Z"
    }
]

Error Responses

404 Not Found

{
    "detail": "Not found"
}

500 Internal Server Error

{
    "detail": "Error message"
}

Integration Notes

Search Features

Historical search tracking
Date-based filtering
Organization isolation
User-specific results

Data Management

SingleStore integration
Result persistence
Query optimization
Timestamp tracking

Security Features

User authentication
Organization validation
Data isolation
Access control

Integration with Other Agents

Niger: Data persistence
Humile: Response normalization (optional)
Atta: User verification

Yuno Humile