# Get the current workspace

`GET /v1/workspace`

Returns the workspace the current credentials are scoped to. Requires at least read access to that workspace.

## Code samples

### CLI

```sh
bird workspace get
```

### cURL

```sh
curl -X GET "https://us1.platform.bird.com/v1/workspace" \
  -H "Authorization: Bearer $TOKEN"
```

## Example response `200`

```json
{
  "id": "ws_01krdgeqcxet5s7t44vh8rt9mg",
  "organization_id": "org_01krdgeqcxet5s7t44vh8rt9mg",
  "name": "Production",
  "notification_emails": {
    "operational": [
      "alerts@example.com"
    ]
  },
  "created_at": "2026-05-20T09:14:52Z",
  "updated_at": "2026-05-25T16:42:01Z"
}
```

## Response body

- `id` (string, required)
- `organization_id` (string, required)
- `name` (string, required)
- `notification_emails` (object, required)
- `notification_emails.operational` (array of string): Addresses for operational notifications about this workspace (sending domain authentication failures, webhook endpoint degradation). When empty, these notifications go to the organization owners. Maximum 10 addresses.
- `logo_url` (nullable string): HTTPS URL to the current workspace logo. `null` when unset.
- `created_at` (string, required)
- `updated_at` (string, required)