Skip to main content
POST
Create Workspace API Key

Authorizations

Authorization
string
header
required

Use Tuner API key (tr_api_...) or user session token. Find your API key in Workspace Settings > API Keys.

Path Parameters

workspace_id
integer
required

Workspace ID. Find this in Workspace > General Settings.

Body

application/json

Request schema for minting a workspace API key.

name
string
required

Names where the key runs, e.g. 'prod'. Unique among the workspace's live keys.

Required string length: 1 - 100
Example:

"prod"

Response

Successful Response

A newly minted key, carrying its plaintext value.

Separate from WorkspaceApiKeyResponse so the value cannot leak into the list endpoint by accident. This is the only response in the system that contains one.

id
integer
required
name
string
required
last_four
string
required
created_at
string<date-time>
required
api_key
string
required

The full key. Shown once and never retrievable again.

last_used_at
string<date-time> | null