REST API & MCP

API Documentation

Everything you need to integrate Curyloop into your workflows. Authenticate with API keys, manage groups and sessions, and connect via MCP for AI-powered access.

Full-text search across items, sessions, and groups in your Curyloop workspace.

Search

Search across all your accessible content in Curyloop using full-text search powered by PostgreSQL.

Search Items

GET /api/v1/search

Query Parameters

ParameterTypeRequiredDescription
qstringYesSearch query (min 2 chars)
typestringNoitems, sessions, or groups
group_idstringNoLimit search to a specific group
limitnumberNoResults per page (default 20)

Response

json
{
  "data": {
    "items": [
      {
        "id": "uuid",
        "url": "https://example.com/article",
        "title": "Matching Article Title",
        "description": "Content matching the search query...",
        "group_name": "Engineering Team",
        "session_title": "Week 10",
        "relevance": 0.95
      }
    ],
    "total": 42
  }
}

Search Tips

  • Use quotes for exact phrases: "react server components"
  • Multiple words use AND logic by default
  • Search covers item titles, descriptions, URLs, and tags
  • Results are ranked by relevance score
  • Only items from groups you're a member of are returned