v1

latestOpenAPI 3.0.32026-07-26303155.1 KB
Lyro

Get Lyro data sources

Returns a paginated list of data sources used by the Lyro AI Agent.

Data sources provide knowledge that Lyro uses to answer customer questions.

Structure

Data sources are organized in a two-level hierarchy based on their kind:

  • folder – top-level containers grouping scraped or imported QA pairs as children. Includes websites, Zendesk Help Centers articles, PDF files, and more. The type field reflects the specific source type (e.g. website, zendesk_hc). The content field is always null for folders. Folder items of type=website additionally populate source_url, skip_auto_sync, manual_sync_available_at, and next_auto_sync_at.

  • qa – individual question-answer pairs. Can be:

    • Standalone (manually created) — parent_id is null
    • Children of a folder (scraped/imported) — parent_id links to the parent folder's id

    The content field is populated for QA items.

By default, the list includes both top-level folders and all QA items (including children). Use the kind and parent_id filters to narrow results.

Sorting

Results are sorted by updated_at descending by default.

Pagination

Use the cursor value from the meta object to fetch the next page. When meta.cursor is null, there are no more pages.

get/lyro/data-sources

Query parameters

cursorstring
Example:aWRfX2U2YTgyYTc0LTExNzAtNGY1Ny1hMDMxLWIzNmYzZjZiYzA5Mw==

Value from the previous page. Use null to fetch the first one

kindstring[]

Filter by data source kind. Multiple values can be provided as a comma-separated list (e.g. kind=qa,folder). Use qa for individual question-answer pairs, folder for top-level containers (e.g. websites).

parent_idstring uuid

Filter by parent data source ID (UUID). Returns only direct children of the given folder.

order'asc' | 'desc'

Sort order by updated_at. Defaults to desc.

Response

Paginated list of data sources