Build an Image
build_imageBuild a container image on Control Plane and push it to the org's private registry, from a GitHub or GitLab repository (repoUrl) or from the app files stored with write_app_files (omit repoUrl). No Docker daemon is involved: the service detects how to build (Dockerfile when present, otherwise auto-detected) and always produces linux/amd64. Returns a buildId to read with get_image_build. The build keeps running after this call returns. Building an existing NAME:TAG replaces that image. A private repository needs a one-time browser authorization per org; this tool returns the link when that is missing. A folder on the user's machine still goes through the CLI: cpln image build --remote --dir PATH --name NAME:TAG --org ORG.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"tag": "<tag>"
},
"name": "build_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| org | No | Organization slug. | |
| tag | Yes | Tag for this build, e.g. "v1.2.0". Required, there is no default. Building an EXISTING tag REPLACES it, and any workload on that tag with dynamic-tag support redeploys onto the new image. Prefer a fresh tag. | |
| name | Yes | Image name WITHOUT the tag, e.g. "my-app". The result is referenced in a workload as //image/NAME:TAG. | |
| branch | No | Branch to build. Omit for the repository's default branch. | |
| noCache | No | Rebuild every step, ignoring cached layers. Slower — only when a cached layer is suspect. | |
| repoUrl | No | HTTPS URL of the repository to build, e.g. "https://github.com/acme/api". GitHub and GitLab only. SSH remotes and URLs with embedded credentials are rejected. A private repo needs a one-time browser authorization per org, which this tool returns a link for. OMIT it to build the app files stored under this NAME with write_app_files. | |
| connectNonce | No | Only when retrying after the user authorized the git provider: echo this tool's previous `connectNonce` verbatim. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| data | No | The full result. Read this, not only the summary. | |
| details | No | ||
| summary | Yes | ||
| nextSteps | No |