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

# ワークスペース取得

> API キーに紐づくデフォルトワークスペースの情報を取得します

# ワークスペース取得

API キーに紐づくユーザーのデフォルトワークスペースを返します。

<Note>
  REST API のエージェント実行エンドポイントでは `workspaceId` は不要です。API キーから自動的に取得されます。このエンドポイントはワークスペース情報の参照にのみ使用してください。
</Note>

## リクエスト

```
GET /api/v1/workspace
```

### ヘッダー

| ヘッダー            | 必須 | 説明                             |
| --------------- | -- | ------------------------------ |
| `Authorization` | はい | `Bearer snorbe_...` 形式の API キー |

## レスポンス

```json theme={null}
{
  "workspaceId": "cmkt9lpfe000bu95cdrcr2nbt",
  "workspaceName": "My Workspace"
}
```

### レスポンスフィールド

| フィールド           | 型        | 説明         |
| --------------- | -------- | ---------- |
| `workspaceId`   | `string` | ワークスペース ID |
| `workspaceName` | `string` | ワークスペース名   |

## 使用例

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://app.snorbe.deskrex.ai/api/v1/workspace" \
    -H "Authorization: Bearer snorbe_your_api_key_here"
  ```

  ```python Python theme={null}
  import requests

  resp = requests.get(
      "https://app.snorbe.deskrex.ai/api/v1/workspace",
      headers={"Authorization": "Bearer snorbe_your_api_key_here"},
  )
  data = resp.json()
  print(data["workspaceId"])
  ```

  ```typescript TypeScript theme={null}
  const resp = await fetch("https://app.snorbe.deskrex.ai/api/v1/workspace", {
    headers: { Authorization: "Bearer snorbe_your_api_key_here" },
  });
  const data = await resp.json();
  console.log(data.workspaceId);
  ```
</CodeGroup>

## エラーレスポンス

| HTTP ステータス | コード                 | 説明                    |
| ---------- | ------------------- | --------------------- |
| 401        | `UNAUTHORIZED`      | API キーが無効、期限切れ、または未指定 |
| 429        | `TOO_MANY_REQUESTS` | レート制限超過               |