Define create workspace proto

components/public-api/gitpod/v1/workspace.proto

@@ -22,6 +22,13 @@ service WorkspaceService {
 
   // ListWorkspaces returns a list of workspaces that match the query.
   rpc ListWorkspaces(ListWorkspacesRequest) returns (ListWorkspacesResponse) {}
+
+  // CreateAndStartWorkspace creates a new workspace and starts it.
+  rpc CreateAndStartWorkspace(CreateAndStartWorkspaceRequest)
+      returns (CreateAndStartWorkspaceResponse) {}
+
+  // StartWorkspace starts an existing workspace.
+  rpc StartWorkspace(StartWorkspaceRequest) returns (StartWorkspaceResponse) {}
 }
 
 message GetWorkspaceRequest { string workspace_id = 1; }
@@ -65,6 +72,51 @@ message ListWorkspacesResponse {
   PaginationResponse pagination = 2;
 }
 
+message CreateAndStartWorkspaceRequest {
+  message Source {
+
+    message Git {
+      string clone_url = 1;
+
+      // ref is an alternatively symbolic. e.g. refs/tags/v1.0,
+      // 9585191f37f7b0fb9444f35a9bf50de191beadc2
+      string ref = 2;
+
+      // create_local_branch is the branch you want to create based on provided
+      // clone_url and ref when workspace started
+      string create_local_branch = 3;
+    }
+
+    Git git = 1;
+  }
+
+  string organisation_id = 1;
+
+  string project_id = 2;
+
+  Source source = 3;
+
+  repeated WorkspaceEnvironmentVariable additional_env_variables = 4;
+
+  string region = 5;
+
+  string workspace_class = 6;
+
+  EditorReference editor = 7;
+
+  string name = 8;
+
+  bool pinned = 9;
+
+  bool force_default_config = 10;
+}
+
+message CreateAndStartWorkspaceResponse { Workspace workspace = 1; }
+
+message StartWorkspaceRequest { string workspace_id = 1; }
+
+message StartWorkspaceResponse { Workspace workspace = 1; }
+
 // +resource get workspace
 message Workspace {
   string id = 1;