Sync a ref against its upstream VCS branch

POST 
/api/v1/projects/:project_id/sync

Fetch-on-demand sync. VCS-source projects only.

Resolves the ref's tracked branch to its upstream HEAD sha; when it matches the ref head's recorded commit the sync is a no-op (unchanged, no download). Otherwise the archive is downloaded, normalized, content-addressed and appended, and the ref advances (synced). Provider calls retry transient failures with bounded backoff and fail fast on permanent ones.

• Scope required: projects:manage_source + manager-or-above.
• Archived projects reject the sync (409).

Request

Responses

200

Successful Response

400

Bad request — malformed input or failed validation.

401

Missing, expired, or invalid credentials.

403

Authenticated but not authorized for this resource. Note: cross-organization reads return 404, not 403.

404

Resource not found, or hidden for tenant-enumeration safety (the caller lacks permission to know whether the resource exists).

409

Conflict — the current resource state does not allow this operation (e.g. assessment already started, email already in use).

422

Semantic validation failure — request shape was valid but contents were not.

429

Too many requests — rate limited. Retry after the window resets.

500

Internal server error — unexpected failure.