Create a project
POST
Creates a project from a GitHub repository your team connected (githubInstallationId + githubRepoId), from a starter (template), or empty. A new project starts its first VM on its own; welcomeVm says how that went.
apiKeyheader
AuthorizationBearer <hmk_…>An API key from the dashboard or homemade api-key create.
application/json- body
config?defaultBranch?stringgithubInstallationId?integerRange
-9007199254740991 <= value <= 9007199254740991githubRepoId?integerRange
-9007199254740991 <= value <= 9007199254740991name?stringLength
1 <= length <= 100orgId?stringrootDirectory?|nullsetupWithAgent?booleantemplate?stringLength
1 <= length <= 64The project.
application/json- response
project*A project: one repository (or starter) that VMs boot from.
welcomeVm*||||The first VM a new project starts on its own.
curl -X POST 'https://api.homemade.dev/api/projects' \ -H 'Content-Type: application/json' \ -d '{}'Example Response
{ "project": { "createdAt": "2019-08-24T14:15:22Z", "defaultBranch": "string", "githubRepoFullName": "string", "id": "string", "name": "string", "orgId": "string", "rootDirectory": "string", "slug": "string", "status": "string", "property1": null, "property2": null }, "welcomeVm": { "status": "created", "vmId": "string" }}