Optimize API | Genlytic Docs

GET/v1/optimize/actions

Returns the current impact queue for your workspace.

Parameter	Req	Description
statusstring	—	Filter by status: `todo` `in_progress` `done` `applied` `dismissed`.
periodstring	—	`7d` `30d` `90d`. Filters by `updatedAt`. Omit to return all actions.
limitnumber	—	Page size, 1–100. Default: 50.
cursorstring	—	Pagination cursor from a previous response's `pagination.nextCursor`.

{
  "data": [
    {
      "id": "6868b4c1f2a3b4c5d6e7f8a9",
      "title": "Schema Gap: FAQPage Missing",
      "description": "Homepage has no FAQPage schema...",
      "status": "todo",
      "impactScore": 3,
      "effort": 2,
      "createdAt": "2026-06-12T09:41:00.000Z",
      "updatedAt": "2026-06-12T09:41:00.000Z"
    }
  ],
  "pagination": { "hasMore": false, "nextCursor": null }
}

PATCH/v1/optimize/actions/{id}

Update the status of an action. Requires optimize:write scope.

Parameter	Req	Description
statusstring	yes	`todo` `in_progress` `done` `applied` `dismissed`

{
  "data": {
    "id": "6868b4c1f2a3b4c5d6e7f8a9",
    "status": "applied",
    "updatedAt": "2026-06-12T09:41:00.000Z",
    "completedAt": "2026-06-12T09:41:00.000Z",
    "baselineVisibility": 71
  }
}

Setting status to applied records a baselineVisibility snapshot (from your most recent visibility snapshot) so outcome impact can be measured later. completedAt and baselineVisibility are null for any other status.