Skip to main content
POST
Crear API key para el usuario de servicio

Permisos

Requiere un usuario de servicio con el permiso ManageAccountServiceUsers a nivel de la empresa.

Autorizaciones

Authorization
string
header
requerido

Credencial de usuario de servicio (prefijo: cog_)

Parámetros de ruta

service_user_id
string
requerido

ID del usuario de servicio (prefijo: service-user-)

Ejemplo:

"service-user-abc123def456"

Cuerpo

application/json
name
string
requerido
Required string length: 1 - 256
expires_at
integer | null

Vencimiento opcional como marca de tiempo UNIX en segundos. Debe estar en el futuro si se proporciona.

Respuesta

Respuesta exitosa

Modelo de respuesta compartido para la creación/rotación de API key (incluye un token de un solo uso).

api_key_id
string
requerido
api_key_name
string
requerido
token
string
requerido

El token de API sin procesar. Solo se muestra una vez, en el momento de la creación o la rotación.