Skip to main content

​
Search API

​
POST /api/v1/search

Search through memos using semantic search. Authentication: Project API Key from https://platform.useskald.com Request (using Project API Key): 
{
    "query": "quarterly goals",
    "limit": 10,
    "filters": [
        {
            "field": "source",
            "operator": "eq",
            "value": "notion",
            "filter_type": "native_field"
        },
        {
            "field": "level",
            "operator": "eq",
            "value": "beginner",
            "filter_type": "custom_metadata"
        },
        {
            "field": "tags",
            "operator": "in",
            "value": ["meeting", "q1"],
            "filter_type": "native_field"
        }
    ]
}
Request (using Token Authentication): 
{
    "query": "quarterly goals",
    "project_id": "project-uuid",
    "limit": 10,
    "filters": [
        {
            "field": "source",
            "operator": "eq",
            "value": "notion",
            "filter_type": "native_field"
        }
    ]
}
Parameters:
  • query (string, required): The search query.
  • project_id (UUID, optional): Only required when using Token Authentication.
  • limit (integer, optional): Max results to return (1-50, default 10).
  • filters (array of filter objects, optional): Array of filters to apply. See Filters for detailed documentation.
Response: 
{
    "results": [
        {
            "memo_title": "Meeting Notes",
            "memo_uuid": "memo-uuid",
            "chunk_uuid": "chunk-uuid",
            "chunk_content": "Full content of the chunk...",
            "memo_summary": "Discussion about Q1 goals",
            "distance": 0.234
        }
    ]
}
Notes:
  • distance is the vector similarity distance (lower is more similar).
  • Empty filters array is equivalent to no filters.
Error Responses: Missing query (400): 
{
    "error": "Query is required"
}
Invalid search method (400): 
{
    "error": "Search method is required and must be one of: title_contains, title_startswith, chunk_vector_search"
}
Limit too high (400): 
{
    "error": "Limit must be less than or equal to 50"
}
Invalid filter (400): 
{
    "error": "Invalid filter: <specific error message>"
}
See Filters for complete filter documentation and examples.