BuildRequest

A project’s files, sent to be validated or deployed into a namespace. The SDKs and the mt CLI build this from a project folder for you.

Kind: an object, used in requests.

Fields

Field	Type	Required	Description
isDeploy	boolean	yes	True to deploy the definitions if the build succeeds; false only to validate them. Constraints: required (empty or whitespace-only strings are rejected).
agents	BuildRequestItem[]	yes	Agent files (agents/). Constraints: required (empty or whitespace-only strings are rejected).
capsules	BuildRequestItem[]	yes	Capsule files (capsules/). Constraints: required (empty or whitespace-only strings are rejected).
connectors	BuildOpenApiAndMcpRequest	yes	Connector files (connectors/). Constraints: required (empty or whitespace-only strings are rejected).
externalOperations	BuildOpenApiAndMcpRequest	yes	Tool files (external-operations/). Constraints: required (empty or whitespace-only strings are rejected).
interactions	BuildInteractionsRequest	yes	Interaction files (interactions/). Constraints: required (empty or whitespace-only strings are rejected).
apps	BuildRequestApp[]	yes	Apps (apps/), one entry per app folder. Constraints: required (empty or whitespace-only strings are rejected).
codePipelines	BuildRequestCodePipeline[]	yes	Code pipeline definitions (code-pipelines/), sent as JSON. Constraints: required (empty or whitespace-only strings are rejected).
codePipelineHooks	map<string,BuildRequestApp> | null		Optional Cogniscript hooks for code pipelines (code-pipeline-hooks/), keyed by the pipeline’s name.
looms	BuildRequestItem[] | null		Optional named looms (looms/<name>.mtr).
resourceFiles	ResourceFileReferences	yes	The shared prompts and JSON files the other files read with @prompt and @json. Constraints: required (empty or whitespace-only strings are rejected).

Example

{
  "isDeploy": false,
  "agents": [
    {
      "name": "...",
      "filename": "...",
      "lines": []
    }
  ],
  "capsules": [
    {
      "name": "...",
      "filename": "...",
      "lines": []
    }
  ],
  "connectors": {
    "openApi": [
      {}
    ],
    "modelContextProtocol": [
      {}
    ]
  },
  "externalOperations": {
    "openApi": [
      {}
    ],
    "modelContextProtocol": [
      {}
    ]
  },
  "interactions": {
    "oneShot": [
      {}
    ],
    "roundRobin": [
      {}
    ],
    "managed": [
      {}
    ]
  },
  "apps": [
    {
      "name": "...",
      "metadata": {},
      "code": []
    }
  ],
  "codePipelines": [
    {
      "name": "...",
      "filename": "...",
      "json": "..."
    }
  ],
  "codePipelineHooks": {
    "key": {
      "name": "...",
      "metadata": {},
      "code": []
    }
  },
  "looms": [
    {
      "name": "...",
      "filename": "...",
      "lines": []
    }
  ],
  "resourceFiles": {
    "prompts": [
      {}
    ],
    "json": [
      {}
    ]
  }
}

Where it’s used

• builds.deploy (PUT /namespaces/{namespaceName}/build)