List workspace projects

Returns all authorized projects of the user. If the user has admin rights, he’ll receive a list of all projects in the workspace.

Required scopes: WORKSPACE

Resource URL

GET /workspaces/:domain/projects

URL Parameters

NameTypeDescription
domain
Required
StringThe workspace domain.

GET Parameters

NameTypeDescription
membershipBooleanIf set to “true”, the admin will receive only the projects to which he belongs in the workspace.
pageIntegerThe number of the successive page (results are splitted by pages of per_page elements each).
per_pageIntegerThe number of returned elements on the page.
sort_byStringSpecifies ordering. Can be one of name, create_date or repository_size.
sort_directionStringSpecifies direction of ordering. Can be one of ASC or DESC.
statusStringFilters projects to the specified status. Can be one of ACTIVE or CLOSED.

Example

Request

GET https://api.buddy.works/workspaces/buddy/projects?page=1&per_page=2

Sample Response

HTTP

Status: 200 OK
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999

JSON

{
"url": "https://api.buddy.works/workspaces/buddy/projects",
"html_url": "https://app.buddy.works/buddy",
"projects": [
{
"url": "https://api.buddy.works/workspaces/buddy/projects/company-website",
"html_url": "https://app.buddy.works/buddy/company-website",
"name": "company-website",
"display_name": "Company Website",
"status": "ACTIVE"
}
]
}