Projects in workspace

GET
/workspaces
/:workspace
/projects

Returns all projects of the authorized user. Users with admin rights get a list of all projects in the workspace.

Request

REQUIRED SCOPES

WORKSPACE

URL PARAMETERS

workspacerequired string

The workspace domain.

GET PARAMETERS

membershipboolean

If set to true, administrators get only the projects to which they belong in the workspace.

pageinteger

The number of the successive pages (results are split into pages of per_page elements each).

per_pageinteger

Specifies the number of returned elements on the page. The default value is 20.

sort_bystring

Specifies ordering. Can be one of name, create_date or repository_size.

sort_directionstring

Specifies the direction of the ordering. Can be one of ASC or DESC.

statusstring

Filters projects by the specified status. Can be one of ACTIVE or CLOSED.

Last modified on Mar 3, 2025

Group in project Members

Example:

CURL
curl -X GET "https://api.buddy.works/workspaces/:workspace/projects" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "Content-Type: application/json"

EXAMPLE RESPONSE
{
  "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"
    }
  ]
}

STATUS
200 OK

LIMITS
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999