Saltar al contenido principal
POST
Python (SDK)

Autorizaciones

Authorization
string
header
requerido

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Encabezados

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Parámetros de ruta

tool_set_id
string
requerido

Cuerpo

application/json
spec
requerido

El documento OpenAPI 3.0 o 3.1, como objeto o como texto JSON o YAML (como máximo 4 MiB).

Minimum string length: 1
name
string

Etiqueta para el conjunto de herramientas. Por defecto, un slug del info.title del documento.

Pattern: ^[a-zA-Z0-9_-]{1,64}$
server_url
string

La URL base pública de la API. Por defecto, es el primer servidor del documento, con las variables establecidas en sus valores predeterminados.

Maximum string length: 2048
operations
string[]

operationIds a importar. Por defecto, todas las operaciones compatibles (como máximo 128).

Required array length: 1 - 128 elements
Required string length: 1 - 64
mcp_server_id
string

Servidor de bóveda de credenciales, registrado para la URL base de la API, cuya credencial autentica cada llamada.

mcp_credential_id
string

Credencial de mcp_server_id a usar. De forma predeterminada, será la credencial activa más reciente del servidor en tiempo de ejecución.

Respuesta

Conjunto de herramientas OpenAPI

object
enum<string>
requerido
Opciones disponibles:
agent.openapi_tool_set
id
string
requerido
name
string
requerido
title
string | null
requerido

La info.title del documento.

version
string | null
requerido

La info.version del documento.

definition
object
requerido

La definición normalizada de la herramienta que envía una ejecución del agente. Contiene referencias de credenciales, nunca valores de credenciales.

skipped_operations
object[]
requerido

Operaciones del documento que no se importaron, y por qué.

authentication
object[]
requerido

Lo que los esquemas de seguridad del documento esperan que la credencial del vault envíe.

created_at
string<date-time>
requerido
updated_at
string<date-time>
requerido