# List projects

Source: https://www.jawsdeploy.net/rest-api/projects-list | Section: Projects

List the projects visible to the service account in a workspace.

`GET /api/project`

Returns every project the authenticated service account can see in the given workspace.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `workspaceId` | query | string | yes | ID of the workspace to list projects in. |

## Errors

| Status | Meaning |
|---|---|
| 400 | Invalid `workspaceId`. |
| 401 | Missing or invalid Basic auth credentials, or the service account lacks the required role. |

Example request:

```
GET /api/project?workspaceId=ws_abc HTTP/1.1
Authorization: Basic <base64(...)>
```

Example response:

```
{
  "workspaceId": "ws_abc",
  "projects": [
    { "projectId": "prj_abc123", "name": "Acme web", "description": "Main site" }
  ]
}
```