Docs

list_learnings

List a project's learnings, strongest evidence first by default. Each learning includes related_experiments plus last_synced_at and sync_status. Wait and list again while sync_status is syncing. Pass nextCursor to fetch the next page.

Operation ID: list_learnings

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 }

Field	Type	Required	Description
`project_id`	uuid	Yes	Project id from list_projects.
`limit`	integer	No	Page size. Default 50, max 50.
`cursor`	string	No	Opaque cursor from the previous page's nextCursor. Omit for the first page.
`order_by`	string	No	Sort field. strength_of_evidence (default), created_at, updated_at, or title.
`order`	string	No	Sort direction. desc (default) or asc.

Function schema:

{
  "name": "list_learnings",
  "description": "List a project's learnings, strongest evidence first by default. Each learning includes related_experiments plus last_synced_at and sync_status. Wait and list again while sync_status is syncing. Pass nextCursor to fetch the next page. You need the learnings in a project, or the next page of that list.",
  "parameters": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "project_id": {
        "type": "string",
        "format": "uuid",
        "description": "Project id from list_projects."
      },
      "limit": {
        "type": "integer",
        "description": "Page size. Default 50, max 50."
      },
      "cursor": {
        "type": "string",
        "description": "Opaque cursor from the previous page's nextCursor. Omit for the first page."
      },
      "order_by": {
        "type": "string",
        "description": "Sort field. strength_of_evidence (default), created_at, updated_at, or title."
      },
      "order": {
        "type": "string",
        "description": "Sort direction. desc (default) or asc."
      }
    },
    "required": [
      "project_id"
    ]
  }
}

Request:

{
  "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
}