Download S3

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 AMAZON_S3.

bucket_namerequiredstring

The name of the Amazon S3 Bucket.

source_pathrequiredstring

The path from which the file will be downloaded.

destination_pathrequiredstring

The path in which the file will be saved.

integrationrequiredIntegration

The ID of the integration.

overwriteboolean

Replace files if they already exist.

recursiveboolean

If set to true, the whole directory tree is downloaded, otherwise only the files from the path are downloaded.

download_excludesstring[]

The paths and/or files that will be left out during the download.

download_includesstring[]

The exceptions from the ignore patterns set in download_excludes.

Last modified on Jan 19, 2026

Download GCS Elastic Beanstalk

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": "Download files from AWS S3/",
  "type": "DOWNLOAD_S3",
  "trigger_time": "ON_EVERY_EXECUTION",
  "bucket_name": "bucketname",
  "source_path": "source",
  "destination_path": "destination",
  "integration": {
    "identifier": "5ddb7c180fb38be67bd78a88a"
  },
  "overwrite": true,
  "recursive": true,
  "download_excludes": [
    "/tmp",
    "*.log"
  ],
  "download_includes": [
    "/tmp/assets",
    "/tmp/styles"
  ]
}'

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": "Download files from AWS S3/",
  "type": "DOWNLOAD_S3",
  "trigger_time": "ON_EVERY_EXECUTION",
  "last_execution_status": "INITIAL",
  "source_path": "source",
  "bucket_name": "bucketname",
  "integration": {
    "url": "https://api.buddy.works/workspaces/buddy/user/integrations/5dcd43cee36b2f53f1555978",
    "html_url": "https://app.buddy.works/my-id",
    "identifier": "5ddb7c180fb38be67bd78a88a",
    "type": "AMAZON"
  },
  "recursive": true,
  "overwrite": true,
  "destination_path": "destination",
  "download_excludes": [
    "/tmp",
    "*.log"
  ],
  "download_includes": [
    "/tmp/assets",
    "/tmp/styles"
  ],
  "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": "test server",
    "on": "CLICK",
    "refs": [
      "refs/heads/master"
    ],
    "last_execution_status": "SUCCESSFUL",
    "last_execution_revision": "506a3963507943d6908154f4bc9646e829128a08"
  }
}

STATUS
201 Created