Skip to main content
POST
CSharp (SDK)

Authorizations

Authorization
string
header
required

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>.

Headers

X-On-Behalf-Of
string

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

Path Parameters

tool_set_id
string
required

Body

application/json
spec
required

The OpenAPI 3.0 or 3.1 document, as an object or as JSON or YAML text (at most 4 MiB).

Minimum string length: 1
name
string

Label for the tool set. Defaults to a slug of the document's info.title.

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

The API's public base URL. Defaults to the document's first server, with variables set to their defaults.

Maximum string length: 2048
operations
string[]

operationIds to import. Defaults to every supported operation (at most 128).

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

Credential vault server, registered for the API's base URL, whose credential authenticates every call.

mcp_credential_id
string

Credential of mcp_server_id to use. Defaults to the server's newest active credential at run time.

Response

OpenAPI tool set

object
enum<string>
required
Available options:
agent.openapi_tool_set
id
string
required
name
string
required
title
string | null
required

The document's info.title.

version
string | null
required

The document's info.version.

definition
object
required

The normalized tool definition an agent run sends. It holds credential references, never credential values.

skipped_operations
object[]
required

Operations of the document that were not imported, and why.

authentication
object[]
required

What the document's security schemes expect the vault credential to send.

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