> ## Documentation Index > Fetch the complete documentation index at: https://docs.devtune.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get what-works recommendations > Returns channel evidence from canonical closed 14-day improvements, using usable citation rollups or closed answer-fetch comparisons. The reporting window selects when results became available. Open, mixed, no_clear_change, declined and unmeasured results are excluded. sampleSize counts improved interventions per channel, not all attempts. hasCorrelatedData indicates eligible closed improvements; lastCorrelatedAt is the latest result availability time. Legacy averages discount directional confidence and blend citation and answer-fetch dimensions; avgMeasuredEffect has mixed units and is not citation lift. This before/after evidence does not establish causation. Empty evidence returns an empty recommendations array and an explanatory emptyState backed by the canonical scoreboard. Empty-state counts are scoped to actions completed in the reporting window: markedInterventions counts that cohort and correlatedInterventions counts its conclusive outcomes, including declines. These counts do not describe all project history or use the recommendation result-availability date. recentEligibleCorrelations is zero when no eligible improvements fall in the window. ## OpenAPI ````yaml /openapi.json get /projects/{projectId}/intelligence/what-works openapi: 3.1.0 info: title: DevTune API version: 2.0.0 description: >- API for programmatic access to your AI visibility data, webhook subscriptions, and automation workflows. Use this API to integrate DevTune data into CI/CD pipelines, BI tools, AI agents, and operational systems. servers: - url: https://devtune.ai/api/v2 description: Production security: - bearerAuth: [] paths: /projects/{projectId}/intelligence/what-works: get: summary: Get what-works recommendations description: >- Returns channel evidence from canonical closed 14-day improvements, using usable citation rollups or closed answer-fetch comparisons. The reporting window selects when results became available. Open, mixed, no_clear_change, declined and unmeasured results are excluded. sampleSize counts improved interventions per channel, not all attempts. hasCorrelatedData indicates eligible closed improvements; lastCorrelatedAt is the latest result availability time. Legacy averages discount directional confidence and blend citation and answer-fetch dimensions; avgMeasuredEffect has mixed units and is not citation lift. This before/after evidence does not establish causation. Empty evidence returns an empty recommendations array and an explanatory emptyState backed by the canonical scoreboard. Empty-state counts are scoped to actions completed in the reporting window: markedInterventions counts that cohort and correlatedInterventions counts its conclusive outcomes, including declines. These counts do not describe all project history or use the recommendation result-availability date. recentEligibleCorrelations is zero when no eligible improvements fall in the window. operationId: getWhatWorksRecommendations parameters: - name: projectId in: path required: true schema: type: string format: uuid - name: windowDays in: query schema: type: integer enum: - 30 - 90 default: 30 description: >- Fixed rolling window in days. Supported values are 30 and 90. Defaults to 30. - name: limit in: query schema: type: integer default: 5 minimum: 1 maximum: 20 responses: '200': description: What-works recommendations content: application/json: schema: type: object properties: data: type: object properties: recommendations: type: array items: type: object properties: recommendation: type: string channel: type: string sampleSize: type: integer avgImpactScore: type: number avgMeasuredEffect: type: number lastCorrelatedAt: type: - string - 'null' format: date-time hasCorrelatedData: type: boolean emptyState: type: - object - 'null' properties: reason: type: string enum: - no_marked_interventions - no_correlated_interventions - no_recent_correlations - summary_not_refreshed message: type: string requirements: type: array items: type: string counts: type: object properties: markedInterventions: type: integer correlatedInterventions: type: integer recentEligibleCorrelations: type: integer window: type: object properties: days: type: integer dateFrom: type: string format: date dateTo: type: string format: date required: - days - dateFrom - dateTo meta: $ref: '#/components/schemas/Meta' '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '403': $ref: '#/components/responses/ForbiddenError' '429': $ref: '#/components/responses/RateLimitExceededError' components: schemas: Meta: type: object properties: timestamp: type: string format: date-time projectId: type: string format: uuid Error: type: object properties: error: type: string message: type: string status: type: integer required: - error - message - status responses: BadRequestError: description: Bad request content: application/json: schema: $ref: '#/components/schemas/Error' UnauthorizedError: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error' ForbiddenError: description: Forbidden content: application/json: schema: $ref: '#/components/schemas/Error' RateLimitExceededError: description: Rate limit exceeded headers: X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/Error' headers: X-RateLimit-Limit: description: Maximum requests per window schema: type: integer X-RateLimit-Remaining: description: Requests remaining in current window schema: type: integer X-RateLimit-Reset: description: Unix timestamp when the window resets schema: type: integer securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.