Build Docker Image

POST
/workspaces
/:workspace
/projects
/:project_name
/pipelines
/:pipeline_id
/actions

Info

List with common parameters for all Buddy actions

Request

URL PARAMETERS

workspacerequiredstring

The workspace name.

pipeline_idrequiredinteger

The numerical ID of the desired pipeline.

project_namerequiredstring

The name ID of the project.

POST PARAMETERS

namerequiredstring

The name of the action.

typerequiredstring

The type of the action. Should be set to DOCKERFILE.

dockerfile_pathrequiredstring

The path to the desired Dockerfile in the repository. Default is DOCKERFILE.

context_pathstring

The docker build image context path.

docker_image_tagstring

The tag of the Docker image.

loginstring

The username required to connect to the server. Required for delivering the Dockerfile to a private registry.

passwordstring

The password required to connect to the server. Required for delivering the Dockerfile to a private registry.

integrationIntegration

Integration The integration. Required for delivering the Dockerfile to the Amazon ECR, Google GCR, Google Artifact Registry, GitHub Container Registry, Docker Hub.

docker_registrystring

Registry type. Available values: NONE, DOCKER_HUB, AMAZON_ECR, GOOGLE_GCR, GOOGLE_ARTIFACT_REGISTRY, GIT_HUB_CONTAINER_REGISTRY, OTHER. Required for GIT_HUB_CONTAINER_REGISTRY

regionIntegration

The name of the Amazon S3 region. Required for delivering the Dockerfile to the Amazon ECR. The full list of regions is available here.

registrystring

The url to GCR. Can be one of gcr.io, us.gcr.io, eu.gcr.io or asia.gcr.io. Required for Google GCR.

repositorystring

The location of the Docker repository.

build_argsstring[]

The arguments used when building the image from the Dockerfile.

insecure_registryboolean

If set to true, ignore SSL errors upon connecting to the Docker registry.

do_not_prune_imagesboolean

If set to true, dangling images will not be pruned after the build.

buildkitboolean

The Docker BuildKit will be activated while invoking the docker build command. By default, it is set to true.

secretsDockerBuildSecret[]

The list of secrets to be sent using the --secret parameter.

provenancestring

Refers to the --provenance switch of the Docker build. Available values: NONE, MIN, MAX. The default value is NONE.

cache_modestring

Available if the cache_scope in the pipeline where this action is located, is set to WORKSPACE or PROJECT. Defines the Docker cache mode. Available values are MIN or MAX. By default, it is set to MIN.

Last modified on Jan 19, 2026

Build Android App Build Flutter App

Request example


curl -X POST "https://api.buddy.works/workspaces/:workspace/projects/:project_name/pipelines/:pipeline_id/actions" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Build dockerfile",
  "type": "DOCKERFILE",
  "trigger_time": "ON_EVERY_EXECUTION",
  "docker_image_tag": "14.06",
  "region": "us-east-1",
  "integration": {
    "identifier": "5ddb7c180fb38be67bd78a88a"
  },
  "dockerfile_path": "dir/Dockerfile",
  "repository": "MyDockerRepo",
  "insecure_registry": true,
  "do_not_prune_images": true,
  "buildkit": true,
  "secrets": [
    {
      "id": "someSecret",
      "value": "path_to_secret",
      "type": "FILE"
    },
    {
      "id": "mysecret",
      "value": "MY_ENV_VAR_KEY",
      "type": "ENV"
    }
  ],
  "build_args": [
    "key=value"
  ]
}'

Response

EXAMPLE RESPONSE
{
  "url": "https://api.buddy.works/workspaces/buddy/projects/company-website/pipelines/2/actions/2",
  "html_url": "https://app.buddy.works/buddy/company-website/pipelines/action/2/edit",
  "id": 2,
  "name": "Build dockerfile",
  "type": "DOCKERFILE",
  "trigger_time": "ON_EVERY_EXECUTION",
  "last_execution_status": "INITIAL",
  "docker_image_tag": "14.06",
  "region": "us-east-1",
  "integration": {
    "identifier": "5ddb7c180fb38be67bd78a88a"
  },
  "dockerfile_path": "dir/Dockerfile",
  "repository": "MyDockerRepo",
  "insecure_registry": true,
  "do_not_prune_images": true,
  "buildkit": true,
  "secrets": [
    {
      "id": "someSecret",
      "value": "path_to_secret",
      "type": "FILE"
    },
    {
      "id": "mysecret",
      "value": "MY_ENV_VAR_KEY",
      "type": "ENV"
    }
  ],
  "build_args": [
    "key=value"
  ],
  "pipeline": {
    "url": "https://api.buddy.works/workspaces/buddy/projects/company-website/pipelines/2",
    "html_url": "https://app.buddy.works/buddy/company-website/pipelines/pipeline/2",
    "id": 2,
    "name": "Live mirror",
    "on": "CLICK",
    "refs": [
      "refs/heads/master"
    ],
    "last_execution_status": "SUCCESSFUL",
    "last_execution_revision": "506a3963507943d6908154f4bc9646e829128a08"
  }
}

STATUS
201 Created