learnings
Read a project's learnings. Pass action "list", "fetch", or "query". Each learning includes related_experiments plus last_synced_at and sync_status. Wait and call again while sync_status is syncing.
Operation ID: learnings
Read a project's learnings. Pass action "list", "fetch", or "query". Each learning includes related_experiments plus last_synced_at and sync_status. Wait and call again while sync_status is syncing.
When to use: You need the learnings in a project, one learning by id, or the closest matches for a question.
Returns: list and query: { learnings }. fetch: one learning.
| Field | Type | Required | Description |
|---|---|---|---|
action | string | Yes | One of "list", "fetch", "query". |
id | uuid | No | Learning id. Required for fetch. |
project_id | uuid | No | Project id from projects with action "list". Required for list and query. |
query | string | No | Natural-language search text. Required for query. 1–2000 characters. |
limit | integer | No | Page size for list (default 50) or max matches for query (default 10). Max 50. |
cursor | string | No | Opaque cursor from the previous list page's nextCursor. Omit for the first page. |
order_by | string | No | list sort. strength_of_evidence (default), created_at, updated_at, or title. |
order | string | No | list direction. desc (default) or asc. |
Function schema:
{
"name": "learnings",
"description": "Read a project's learnings. Pass action \"list\", \"fetch\", or \"query\". Each learning includes related_experiments plus last_synced_at and sync_status. Wait and call again while sync_status is syncing. You need the learnings in a project, one learning by id, or the closest matches for a question.",
"parameters": {
"type": "object",
"additionalProperties": false,
"properties": {
"action": {
"type": "string",
"description": "One of \"list\", \"fetch\", \"query\"."
},
"id": {
"type": "string",
"format": "uuid",
"description": "Learning id. Required for fetch."
},
"project_id": {
"type": "string",
"format": "uuid",
"description": "Project id from projects with action \"list\". Required for list and query."
},
"query": {
"type": "string",
"description": "Natural-language search text. Required for query. 1–2000 characters."
},
"limit": {
"type": "integer",
"description": "Page size for list (default 50) or max matches for query (default 10). Max 50."
},
"cursor": {
"type": "string",
"description": "Opaque cursor from the previous list page's nextCursor. Omit for the first page."
},
"order_by": {
"type": "string",
"description": "list sort. strength_of_evidence (default), created_at, updated_at, or title."
},
"order": {
"type": "string",
"description": "list direction. desc (default) or asc."
}
},
"required": [
"action"
]
}
}learnings · list
List a project's learnings, strongest evidence first by default. Pass nextCursor to fetch the next page.
When to use: You need the learnings in a project, or the next page of that list.
Returns: { learnings: [{ id, project_id, title, category, summary, strength_of_evidence, related_experiments, last_synced_at, sync_status, created_at, updated_at, source_url }], nextCursor }
Prompt: List learnings in this Garasu project.
Request:
{
"action": "list",
"project_id": "11111111-1111-4111-8111-111111111111",
"limit": 50,
"order_by": "strength_of_evidence",
"order": "desc"
}Response:
{
"learnings": [
{
"id": "44444444-4444-4444-8444-444444444444",
"project_id": "11111111-1111-4111-8111-111111111111",
"title": "Shipping estimates lift checkout completion",
"category": "Checkout",
"summary": "Showing an estimated shipping range on cart raised checkout completion. People dropped off when cost appeared for the first time at payment.",
"strength_of_evidence": 0.72,
"related_experiments": [
"22222222-2222-4222-8222-222222222222"
],
"last_synced_at": "2026-03-29T15:04:00.000Z",
"sync_status": "idle",
"source_url": "https://garasu.co/app/77777777-7777-4777-8777-777777777777/projects/11111111-1111-4111-8111-111111111111/learnings/44444444-4444-4444-8444-444444444444",
"created_at": "2026-03-29T14:12:00.000Z",
"updated_at": "2026-03-29T14:12:00.000Z"
}
],
"nextCursor": null
}learnings · fetch
Get a learning by id, including related experiment ids and the project's last_synced_at and sync_status.
When to use: You have a learning id and need its title, summary, evidence, related experiments, or sync status.
Returns: { id, project_id, title, category, summary, strength_of_evidence, related_experiments, last_synced_at, sync_status, created_at, updated_at, source_url }
Prompt: Get the Garasu learning with this id.
Request:
{
"action": "fetch",
"id": "44444444-4444-4444-8444-444444444444"
}Response:
{
"id": "44444444-4444-4444-8444-444444444444",
"project_id": "11111111-1111-4111-8111-111111111111",
"title": "Shipping estimates lift checkout completion",
"category": "Checkout",
"summary": "Showing an estimated shipping range on cart raised checkout completion. People dropped off when cost appeared for the first time at payment.",
"strength_of_evidence": 0.72,
"related_experiments": [
"22222222-2222-4222-8222-222222222222"
],
"last_synced_at": "2026-03-29T15:04:00.000Z",
"sync_status": "idle",
"source_url": "https://garasu.co/app/77777777-7777-4777-8777-777777777777/projects/11111111-1111-4111-8111-111111111111/learnings/44444444-4444-4444-8444-444444444444",
"created_at": "2026-03-29T14:12:00.000Z",
"updated_at": "2026-03-29T14:12:00.000Z"
}learnings · query
Search a project's learnings by semantic similarity. Returns the closest matches, not a full catalog.
When to use: You need existing learnings related to a question, hypothesis, or idea in this project.
Returns: { learnings: [{ id, project_id, title, category, summary, strength_of_evidence, similarity, related_experiments, last_synced_at, sync_status, created_at, updated_at, source_url }] }
Prompt: Find learnings in this Garasu project about shipping cost at checkout.
Request:
{
"action": "query",
"project_id": "11111111-1111-4111-8111-111111111111",
"query": "shipping cost transparency at checkout",
"limit": 10
}Response:
{
"learnings": [
{
"id": "44444444-4444-4444-8444-444444444444",
"project_id": "11111111-1111-4111-8111-111111111111",
"title": "Shipping estimates lift checkout completion",
"category": "Checkout",
"summary": "Showing an estimated shipping range on cart raised checkout completion. People dropped off when cost appeared for the first time at payment.",
"strength_of_evidence": 0.72,
"related_experiments": [
"22222222-2222-4222-8222-222222222222"
],
"last_synced_at": "2026-03-29T15:04:00.000Z",
"sync_status": "idle",
"source_url": "https://garasu.co/app/77777777-7777-4777-8777-777777777777/projects/11111111-1111-4111-8111-111111111111/learnings/44444444-4444-4444-8444-444444444444",
"created_at": "2026-03-29T14:12:00.000Z",
"updated_at": "2026-03-29T14:12:00.000Z",
"similarity": 0.86
}
]
}