VCS

• API Name: Execute VCS Action
• API Route: POST /api/v1/vsc/execute
• Request:

  • Body:

    {
      "provider": "github | azure (required)",
      "repositorySource": "github | azureDevOps (required)",
      "action": "string (required)",
      "workspaceId": "string (required)",
      "projectId": "string (required)",
      "params": { "...actionSpecificParams" }
    }

• What it does: Acts as a unified dispatcher for all VCS operations. Resolves the VCS token (GitHub or Azure OAuth token) for the given provider, selects the appropriate VCS service via VSCFactory, and dynamically calls the specified action method on the service. Supports all actions exposed by the GitHub and Azure DevOps service implementations (e.g., clone, commit, push, listRepos, createBranch, etc.).
• Returns:

  {
    "success": true,
    "data": "...action result"
  }

Returns 400 if the action is not supported by the provider. Returns 500 with error details on failure.