---
title: "Create Workspace Activation Key"
method: POST
path: "/v1/workspaces/{workspace_id}/activation/key"
tags: ["workspace-activation"]
---

# Create Workspace Activation Key

`POST /v1/workspaces/{workspace_id}/activation/key`

Issue the workspace's setup API key, rotating the one the guide already issued.

Workspace owners and admins only, like every other action that changes a
workspace. The plaintext is returned once and never stored, so a reopened
guide rotates the same key row rather than collecting a second one, and
answers 409 once the workspace has activated or the guide was dismissed.

## Path parameters

- `workspace_id` string, uuid, required

## Response `201`

Successful Response

- ActivationApiKeyPublic — The API key the guide hands out, with its plaintext. Returned once per call and never stored in plaintext, like every other key this gateway mints: a page reload issues a new one and rotates the same row, which is what makes the guide able to show a working key without keeping a readable secret anywhere.
  - `key` string, required
  - `key_id` string, required
  - `key_name` string, nullable, required
  - `key_prefix` string, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.net/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mozilla-ai/otari/revisions/2d6e4912e230/schema)