Push Docker Image

  • POST
  • /workspaces
  • /:workspace
  • /projects
  • /:project_name
  • /pipelines
  • /:pipeline_id
  • /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 DOCKER_PUSH.
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
regionstring
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 the 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.
docker_build_action_idinteger
The ID of the action which built the desired Docker image. If set to 0, the image will be taken from previous pipeline action. Can be used instead of docker_build_action_name.
docker_build_action_namestring
The name of the action which built the desired Docker image. Can be used instead of docker_build_action_id.

Last modified on Jan 19, 2026

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": "Push to registry", "type": "DOCKER_PUSH", "trigger_time": "ON_EVERY_EXECUTION", "docker_image_tag": "14.06", "region": "us-east-1", "integration": { "identifier": "5ddb7c180fb38be67bd78a88a" }, "docker_build_action_id": 1, "repository": "MyDockerRepo" }'

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/pipeline/2/action/2/edit", "id": 2, "name": "Push to registry", "type": "DOCKER_PUSH", "trigger_time": "ON_EVERY_EXECUTION", "last_execution_status": "INITIAL", "docker_build_action_id": 1, "docker_image_tag": "14.06", "region": "us-east-1", "integration": { "identifier": "5ddb7c180fb38be67bd78a88a" }, "repository": "MyDockerRepo", "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