Trigger Scan
Trigger a new scan for a connected org.
Owner/Admin only (session auth): triggering a scan exercises the stored platform credential and consumes worker capacity — a mutation the workspace role model reserves for Admin/Owner. API-key auth is owner-equivalent and bypasses the role check. (Cancelling an in-flight scan stays member-permitted as an operational action.)
Accepts an optional JSON body with scan_type: "incremental" (default)
skips repos unchanged since the last scan; "full" re-scans every repo.
Creates a Scan record immediately (status=pending) and dispatches
the scan to a Celery worker. Poll GET /scans/ for progress.
Authorizations
Headers
Path Parameters
Cookies
Body
Optional request body for POST /organizations/{org_id}/scans.
