BasicsPipelinesActions & ServicesEnvironmentsIntegrationsTargetsTestsDomainsSandboxesSelf-HostedAgents & TunnelsYAMLBuddy GitFAQAPI

Rsync (Password)

View as Markdown
  • 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 RSYNC.
authentication_moderequiredstring
The authentication mode for SSH. Should be set to PASS.
hostrequiredstring
The host for the connection.
loginrequiredstring
The username required to connect to the server.
passwordrequiredstring
The password required to connect to the server.
portrequiredstring
The port for the connection.
input_typestring
Defines whether the files are deployed from the repository or from the build filesystem. Can be one of SCM_REPOSITORY or BUILD_ARTIFACTS.
local_pathstring
The path in the repository.
remote_pathstring
The absolute or relative path on the remote server.
archiveboolean
An equivalent for rsync -a option. See here.
compressboolean
An equivalent for rsync -z option. See here.
recursiveboolean
An equivalent for rsync -r option. See here.
dirsboolean
An equivalent for rsync -d option. See here.
delete_extra_filesboolean
Defines whether additional files on the server (that are not present in repository or in the filesystem), should be deleted.
deployment_excludesstring[]
The paths and/or files that will be left out during the deployment.
deployment_includesstring[]
The exceptions from the ignore patterns set in deployment_excludes.

Last modified on Jan 19, 2026

Previous pageRollbar notificationNext pageRsync (Private key)

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": "Upload files to 123.45.67.89",
  "type": "RSYNC",
  "trigger_time": "ON_EVERY_EXECUTION",
  "authentication_mode": "PASS",
  "host": "123.45.67.89",
  "port": "22",
  "login": "api_tests_user",
  "password": "${rsync_password}",
  "input_type": "SCM_REPOSITORY",
  "local_path": "/",
  "remote_path": "Home/www/",
  "archive": true,
  "compress": false,
  "recursive": true,
  "dirs": true,
  "delete_extra_files": false,
  "deployment_excludes": [
    "/tmp/",
    "*.log"
  ],
  "deployment_includes": [
    "/assets/style",
    "/tmp/file.txt"
  ]
}'

Response

EXAMPLE RESPONSE
{
  "url": "https://api.buddy.works/workspaces/buddy/projects/company-website/pipelines/2/actions/855",
  "html_url": "https://app.buddy.works/buddy/company-website/pipelines/action/855/edit",
  "id": 855,
  "name": "Upload files to 123.45.67.89",
  "type": "RSYNC",
  "trigger_time": "ON_EVERY_EXECUTION",
  "last_execution_status": "INITIAL",
  "input_type": "SCM_REPOSITORY",
  "local_path": "/",
  "remote_path": "Home/www/",
  "login": "root",
  "host": "123.45.67.89",
  "port": "22",
  "authentication_mode": "PASS",
  "archive": true,
  "compress": false,
  "recursive": true,
  "dirs": true,
  "delete_extra_files": false,
  "deployment_excludes": [
    "/assets/",
    "file.txt"
  ],
  "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