---
title: "更新空间 API Key 用户身份配置"
method: PUT
path: "/tenants/{id}/api-principal-config"
tags: ["空间管理"]
---

# 更新空间 API Key 用户身份配置

`PUT /tenants/{id}/api-principal-config`

配置 X-API-Key 请求如何映射为终端 Principal（Owner）

## Path parameters

- `id` integer, required

## Request body

- InternalHandlerApiPrincipalConfigRequest
  - `direct_header_name` string
  - `hmac_secret` string
  - `mode` 'tenant' | 'direct_header' | 'signed_token'
  - `require_direct_header` boolean
  - `signed_token_header_name` string

## Response `200`

更新后的配置

- object

## Other responses

- `400` — 请求参数错误
- `403` — 权限不足

---

[API](https://skmtc.net/tencentblueking/apis/weknora-api.md) · [All operations](https://skmtc.net/tencentblueking/apis/weknora-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tencentblueking/weknora-api/revisions/d6921ae22ce0/schema)