GET /projects — list all projects in your workspace

This endpoint returns a paginated list of all projects in your workspace. You can narrow results to a specific folder, filter by one or more content types, and control page size up to 50 results at a time. Use it to build project browsers, sync dashboards, or audit workspace contents.

GET https://api.bugsmash.io/api/v2/projects

Request headers

string

required

Your Bugsmash API key.

Query parameters

integer

Page number to retrieve. Defaults to 1.

integer

Number of results per page. Maximum 50.

uuid

Filter projects by folder UUID. Pass null to return only root-level projects not inside any folder.

string[]

Filter by one or more content types. Accepted values: image, video, pdf, audio, website, ppt, email.

Example

curl --location --globoff \
  'https://api.bugsmash.io/api/v2/projects?page=1&limit=10&folderId=null&types[]=video&types[]=image' \
  --header 'X-API-Key: YOUR_API_KEY'

{
  "status": true,
  "message": "Success",
  "data": {
    "current_page": 1,
    "data": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "name": "Advertisement Thumbnails",
        "owner": "b2c3d4e5-f6a7-8901-bcde-f01234567891",
        "share_access": "public",
        "type": "image",
        "short_url": "https://app.bugsmash.io/review/AbCdE",
        "banner": "https://cdn.bugsmash.io/files/{workspace-id}/image/example-thumbnail.jpg",
        "created_at": "2025-12-05T11:36:19.000000Z",
        "updated_at": "2026-03-06T19:01:17.000000Z"
      }
    ]
  },
  "last_page": 9,
  "per_page": 10,
  "total": 88
}

Response fields

boolean

required

true when the request succeeded.

string

required

Human-readable status message.

object

required

Hide properties

integer

required

The page number returned in this response.

object[]

required

Array of project objects on the current page.

Show project properties

string

required

UUID of the project.

string

required

Display name of the project.

string

required

UUID of the workspace member who created the project.

Access level: "public" or "private".

string

required

Content type: image, video, pdf, audio, website, ppt, or email.

string

required

Shareable review link for this project.

string

URL of the project’s cover image or thumbnail.

string

required

ISO 8601 timestamp of when the project was created.

string

required

ISO 8601 timestamp of the most recent update.

integer

required

Total number of pages available with the current limit.

integer

required

Number of results returned per page.

integer

required

Total number of projects matching the query across all pages.

Folders

Versions

Projects

Comments

Webhooks

GET /projects — list all projects in your workspace

Request headers

Query parameters

Example

Response fields

​Request headers

​Query parameters

​Example

​Response fields

Request headers

Query parameters

Example

Response fields