v1

latestOpenAPI 3.1.02026-07-265897154.5 KB

Opportunities

List opportunities

Actionable opportunities Searchable surfaced for the project — prioritized fix/write/audit suggestions derived from visibility, sentiment, sources, traffic, prompts, site health, and articles. Read-only. Defaults to active opportunities (pass status or includeResolved=true to widen, source/impact to narrow); returns them in the product's priority order plus global stats. Regular-project feature — pitch projects are rejected (403 pitch_not_supported).

get/api/mcp/projects/{projectId}/opportunities

Path parameters

projectIdstring uuid required

The project id.

Query parameters

status'active' | 'completed' | 'dismissed' | 'auto_resolved'

Filter by status. Defaults to active unless includeResolved=true.

includeResolved'true' | 'false'

Pass true to widen beyond active opportunities.

sourcestring

Filter opportunities by their originating source.

impact'critical' | 'high' | 'medium' | 'low'

Filter opportunities by impact level.

limitinteger

Page size. Default and maximum vary by endpoint — see the operation description.

offsetinteger

Row offset for pagination.

Response

Opportunities.