Create
Create a new branch for a project
post/v0/projects/{project}/branches
Create a new branch for a project
Path Parameters
projectstring
optional
Body Parameters
branchstring
Name of the new project branch.
branch_fromstring
Branch or commit SHA to branch from.
forceboolean
optional
Whether to throw an error if the branch already exists. Defaults to false.
Returns
branchstringconfig_commitCommitlatest_buildBuildObjectobjectenumorgstringprojectstringProjectBranch
curl https://api.stainless.com/v0/projects/$PROJECT/branches \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $STAINLESS_API_KEY" \
-d '{
"branch": "branch",
"branch_from": "branch_from"
}'200 Example
{
"branch": "branch",
"config_commit": {
"repo": {
"branch": "branch",
"name": "name",
"owner": "owner"
},
"sha": "sha"
},
"latest_build": {
"id": "id",
"config_commit": "config_commit",
"created_at": "2019-12-27T18:11:19.117Z",
"documented_spec": {
"content": "content",
"type": "content"
},
"object": "build",
"org": "org",
"project": "project",
"targets": {
"cli": {
"commit": {
"status": "not_started"
},
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
},
"upload": {
"status": "not_started"
}
},
"csharp": {
"commit": {
"status": "not_started"
},
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
},
"upload": {
"status": "not_started"
}
},
"go": {
"commit": {
"status": "not_started"
},
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
},
"upload": {
"status": "not_started"
}
},
"java": {
"commit": {
"status": "not_started"
},
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
},
"upload": {
"status": "not_started"
}
},
"kotlin": {
"commit": {
"status": "not_started"
},
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
},
"upload": {
"status": "not_started"
}
},
"node": {
"commit": {
"status": "not_started"
},
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
},
"upload": {
"status": "not_started"
}
},
"php": {
"commit": {
"status": "not_started"
},
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
},
"upload": {
"status": "not_started"
}
},
"python": {
"commit": {
"status": "not_started"
},
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
},
"upload": {
"status": "not_started"
}
},
"ruby": {
"commit": {
"status": "not_started"
},
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
},
"upload": {
"status": "not_started"
}
},
"terraform": {
"commit": {
"status": "not_started"
},
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
},
"upload": {
"status": "not_started"
}
},
"typescript": {
"commit": {
"status": "not_started"
},
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
},
"upload": {
"status": "not_started"
}
}
},
"updated_at": "2019-12-27T18:11:19.117Z"
},
"object": "project_branch",
"org": "org",
"project": "project"
}