Skip to main content
PATCH
Rename an API key or change its tool set

Authorizations

Authorization
string
header
required

Locus Pro dashboard session (Cognito). High-risk workspace administration requires an owner or admin role and fresh MFA/passkey step-up.

Headers

X-Locus-Step-Up
string<password>

Short-lived raw MFA/passkey step-up token bound to the authenticated Cognito subject. Send it alongside the dashboard Bearer token for workspace-administrator mutations when the base session does not itself prove MFA within the last ten minutes. Never send it with a tenant secret key.

Path Parameters

keyId
string<uuid>
required

Key record id from GET /credits/tenants/me/keys.

Body

application/json
name
string
Required string length: 1 - 100
toolSetId
string<uuid> | null

A tool set id from GET /credits/tool-sets, or null for Main.

Response

Updated key metadata under keyMetadata.