POST `/admin/agents/{agent_id}/credentials`

为指定 Agent 生成新的 API 密钥凭证。返回的 api_key 仅展示一次，请妥善保管。

NHI Agents `bearerAuth` application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`agent_id`	`path`	`string`	是				Agent ID

请求体

Schema： agent_domain.CreateAgentCredentialRequest

字段	类型	必填	示例	约束	描述
`name`	`string`	是
`cred_type`	`string`	否

响应

状态	描述	Schema
201	创建的凭证（含一次性 API Key）	`service-core/base/dto.DataResponse-agent_domain_CreateAgentCredentialResult`

引用的 Schema

agent_domain.AgentCredentialInfo

字段	类型	必填	示例	约束	描述
`agent_id`	`string`	否
`created_at`	`string`	否
`cred_type`	`string`	否
`id`	`string`	否
`key_prefix`	`string`	否
`name`	`string`	否
`status`	`string`	否

agent_domain.CreateAgentCredentialResult

字段	类型	必填	示例	约束	描述
`credential`	`agent_domain.AgentCredentialInfo`	否
`raw_key`	`string`	否

service-core/base/dto.DataResponse-agent_domain_CreateAgentCredentialResult

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`agent_domain.CreateAgentCredentialResult`	否
`message`	`string`	否
`timestamp`	`string`	否

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓