> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackshift.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Projects API

> Project listing exposed by the official SDK clients.

Project listing exposed by the official SDK clients. Base URL: `https://api.stackshift.cloud/api/v1`

Authentication: `bearer`. Every operation below is traced to an official SDK source file listed in the generated coverage report.

| Method | SDK route   | SDK method            | Request type         | Response type |
| ------ | ----------- | --------------------- | -------------------- | ------------- |
| `GET`  | `/projects` | `ProjectsClient.list` | `ProjectListOptions` | `Project[]`   |

## Error envelope

Non-2xx responses use the StackShift response envelope. Check `success: false`, then read the structured `error` value and HTTP status. SDK clients surface the status, code, message, and details through their native error type.

## Examples

These static examples show the verified route and authentication boundary. Use the official SDK method shown in each heading so serialization and response unwrapping remain consistent with the contract.

### `GET /projects`

```bash theme={null}
curl -X GET "https://api.stackshift.cloud/api/v1/projects"   -H "Authorization: Bearer $STACKSHIFT_API_KEY"
```

The SDK serializes any supported query options for this operation.

Response:

```json theme={null}
{
  "success": true,
  "data": [
    "example"
  ]
}
```