# Create (v2)

Create a new Workspace with an application key in the v2 key format.

This endpoint works like [Create](/warpstream/reference/api-reference/workspaces/create): it takes the same request and returns the same response. The difference is that the application key created with the workspace is in the [v2 key format](/warpstream/reference/api-reference/api-keys#key-formats).

The application key's secret, `application_key.key` in the response, is only returned by this request. WarpStream does not store the secret and it can't be retrieved later, so save it right away. If the secret is lost, create a new application key with [Create API Key (v2)](/warpstream/reference/api-reference/api-keys/create-v2) and delete the old one.

Pass `"skip_application_key_creation": true` to create the workspace without an application key. `application_key` is then `null` in the response.

## Request

```bash wrap
curl https://api.warpstream.com/api/v1/create_workspace_v2 \
-H 'warpstream-api-key: XXXXXXXXXX' \
-H 'Content-Type: application/json' \
-d '{"workspace_name": "example-workspace", "skip_application_key_creation": false}'
```

## Response

```json wrap
{
  "workspace_id": "wi_d7591578_418f_41cb_bed9_9c4dd7c7470e",
  "application_key": {
      "id": "aki_e6153e40_9baf_4af2_b7e0_0e88d753e50b",
      "name": "akn_example_application_key",
      "key": "aks_v2_e6153e409baf4af2b7e00e88d753e50b_3f8c1d9b5e2a47c0b6d84f1e9a705c3d2b8f6a41c9e5d073b2f8a1c64e9d70b5",
      "created_at": "2026-10-15T00:20:13.365372Z",
      "access_grants": [{
        "principal_kind": "app",
        "resource_kind": "*",
        "resource_id": "*"
      }]
    }
}
```