BasicsPipelinesActions & ServicesEnvironmentsIntegrationsTargetsTestsDomainsSandboxesSelf-HostedAgents & TunnelsYAMLBuddy GitFAQAPI

Tag 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 PROMOTE_IMAGE.
same_locationrequiredboolean
If set to true, promotes the image within the same registry (only tag changes). If false, promotes between different registries.
srcrequiredImageDefinition
Source configuration defining where to pull the image from.
destrequiredImageDefinition
Destination configuration defining where to push the image to.

Last modified on Jan 19, 2026

Previous pageStackHawk CLINext pageTCP monitoring

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": "Promote to production tag",
  "type": "PROMOTE_IMAGE",
  "trigger_time": "ON_EVERY_EXECUTION",
  "same_location": true,
  "src": {
    "docker_registry": "DOCKER_HUB",
    "image": "mycompany/myapp:latest",
    "integration": "docker_hub_integration"
  },
  "dest": {
    "docker_registry": "GOOGLE_ARTIFACT_REGISTRY",
    "registry": "us-central1-docker.pkg.dev",
    "image": "my-gcp-project/my-repo/myapp:production",
    "integration": "google_service_account"
  }
}'

Response

EXAMPLE RESPONSE
{
  "name": "Promote from Docker Hub to Artifact Registry",
  "type": "PROMOTE_IMAGE",
  "trigger_time": "ON_EVERY_EXECUTION",
  "same_location": false,
  "src": {
    "docker_registry": "DOCKER_HUB",
    "image": "mycompany/myapp:latest",
    "integration": "docker_hub_integration"
  },
  "dest": {
    "docker_registry": "GOOGLE_ARTIFACT_REGISTRY",
    "registry": "us-central1-docker.pkg.dev",
    "image": "my-gcp-project/my-repo/myapp:production",
    "integration": "google_service_account"
  }
}