Create project

Every user can add new projects, unless restricted by the admin in the workspace settings.

Required scopes: WORKSPACE

Resource URL

POST /workspaces/:domain/projects

URL Parameters

NameTypeDescription
domain
Required
StringThe workspace domain.

POST Parameters

NameTypeDescription
nameStringName ID of the project (must be unique in workspace). Required when adding the non-integrated project.
display_nameStringFull name of the project. Required when adding the integrated project.
integrationIntegrationThe integration. Required when adding the integrated project.
external_project_idStringRepo slug of the Bitbucket, Github or Gitlab project. Required when adding the integrated project.
git_lab_project_idStringId of the project in Gitlab.
custom_repo_urlStringSSH or HTTPS url of the git repository. Required when adding the project integrated with custom git repository.
custom_repo_userStringUsername used to authorize access to the git repository. Required when adding the project integrated with custom git repository.
custom_repo_passStringPassword used to authorize access to the git repository. Required when adding the project integrated with custom git repository and the provided custom_repo_url is the HTTPS url.

Example

Request

POST https://api.buddy.works/workspaces/buddy/projects

JSON

{
"name": "landing-page",
"display_name": "Landing page"
}

Example

Request

POST https://api.buddy.works/workspaces/buddy/projects

JSON

{
"display_name": "Landing page",
"external_project_id": "buddy/landing-page",
"integration":
{
"id": 1
}
}

Example

Request

POST https://api.buddy.works/workspaces/buddy/projects

JSON

{
"display_name": "Landing page",
"custom_repo_url": "https://github.com/buddy/landing-page.git",
"custom_repo_user": "support@buddy.works",
"custom_repo_pass": "super-secret-password"
}

Sample Response

HTTP

Status: 201 Created
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999

JSON

{
"url": "https://api.buddy.works/workspaces/buddy/projects/landing-page",
"html_url": "https://app.buddy.works/buddy/landing-page",
"name": "landing-page",
"display_name": "Landing page",
"status": "ACTIVE",
"create_date": "2016-03-02T11:10:28.864Z",
"created_by": {
"url": "https://api.buddy.works/workspaces/buddy/member/1",
"html_url": "https://app.buddy.works/buddy/profile/1",
"id": 1,
"name": "Mike Benson",
"avatar_url": "https://app.buddy.works/image-server/user/0/0/0/0/0/0/1/d643744fbe5ebf2906a4d075a5b97110/w/32/32/AVATAR.png",
"title": "Creative director"
},
"http_repository": "https://app.buddy.works/buddy/landing-page",
"ssh_repository": "buddy@app.buddy.works:buddy/landing-page",
"size": 0,
"default_branch": "master"
}